Utilisation de la trace

Calcule l’utilisation par appel pour une trace, avec agrégation des descendants.

POST /trace/usage

Utilisation de la trace

cURL

curl --request POST \
  --url https://api.example.com/trace/usage \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "<string>",
  "filter": {
    "op_names": [
      "<string>"
    ],
    "input_refs": [
      "<string>"
    ],
    "output_refs": [
      "<string>"
    ],
    "parent_ids": [
      "<string>"
    ],
    "trace_ids": [
      "<string>"
    ],
    "call_ids": [
      "<string>"
    ],
    "thread_ids": [
      "<string>"
    ],
    "turn_ids": [
      "<string>"
    ],
    "trace_roots_only": true,
    "wb_user_ids": [
      "<string>"
    ],
    "wb_run_ids": [
      "<string>"
    ]
  },
  "query": {
    "$expr": {
      "$and": [
        {
          "$literal": "<string>"
        }
      ]
    }
  },
  "include_costs": false,
  "limit": 10000
}
'

200

{
  "call_usage": {},
  "unfinished_call_ids": [
    "<string>"
  ]
}

Autorisations

Authorization · string · header · requis

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Corps

application/json

Requête visant à calculer l’Utilisation par appel pour une trace, avec cumul des descendants.

Cet Endpoint renvoie des métriques d’Utilisation pour chaque appel de la trace, où les métriques de chaque appel incluent la somme de sa propre Utilisation et de celle de tous ses descendants. Utilisez-le pour la Vue de trace lorsque vous souhaitez afficher des métriques cumulées par appel.

Remarque : tous les appels correspondants sont chargés en Mémoire pour l’agrégation. Pour des ensembles de résultats très volumineux (>10k appels), envisagez d’utiliser des filtres plus spécifiques ou une pagination au niveau de l’application.

project_id · string · requis

filter · CallsFilter · object

Filtre pour sélectionner les appels. Utilisez généralement trace_ids pour obtenir tous les appels d’une trace.

Show child attributes

query · Query · object

Conditions de requête supplémentaires pour filtrer les appels.

Show child attributes

include_costs · boolean · défaut: false

Si la valeur est true, inclure les calculs de coût dans l’Utilisation.

limit · integer · défaut: 10000

Nombre maximal d’appels à traiter. Sert de limite de sécurité pour éviter une utilisation de la mémoire sans borne.

Réponse

200

application/json

Réponse réussie

Réponse contenant les métriques d’Utilisation par appel (chacune inclut les contributions des descendants).

call_usage · Call Usage · object

Show child attributes

unfinished_call_ids · string[]