Get span summary

Each key is a field to filter on, and each value is a condition: {"<field>": {"operator": "<operator>", "value": [...]}}. A span must match every condition. To set two conditions on one field, such as a range, pass a list of conditions.

Operators: "" (equals, the default), not, in, not_in, lt, lte, gt, gte, contains, not_contains, icontains (ignores case), startswith, not_startswith, endswith, not_endswith, empty, not_empty. Put values in a list: "" and in match any of the listed values, and not and not_in match none of them. Other operators take one value; for empty and not_empty, send [""].

Fields:

• unique_id, trace_unique_id, span_unique_id, span_parent_id, span_name, span_workflow_name, thread_identifier, customer_identifier, customer_email, custom_identifier, group_identifier, evaluation_identifier, organization_key_id, prompt_id, prompt_name, prompt_version_number, model, provider_id, deployment_name, log_type, log_method, status, status_code, environment, error_class, error_code, error_message, error_fingerprint, cache_key, note
• True or false: stream, has_tool_calls, cache_bit, used_custom_credential, positive_feedback
• Numbers: cost, latency, time_to_first_token, tokens_per_second, routing_time, prompt_tokens, completion_tokens, total_request_tokens, prompt_cache_hit_tokens, prompt_cache_creation_tokens. The aliases total_cost, input_tokens, output_tokens and total_tokens also work, and so does trace_id for trace_unique_id.
• metadata__<key>: a custom metadata value. Values are strings, and spans without the key never match, even with not.
• scores__<evaluator_id>: an evaluator's numeric score, with "", not, in, not_in, lt, lte, gt or gte.
• is_root_span ([true] or [false]), fault_domain (user, respan or provider), and behaviors (spans where the named behaviors fired, when span behaviors are on).

Unsupported fields return a 400 error.

Example:

{
  "customer_identifier": {"operator": "", "value": ["alex@acme.dev"]},
  "status_code": {"operator": "not", "value": [200]}
}