> ## Documentation Index > Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt > Use this file to discover all available pages before exploring further. # Utilisation de la trace > Calcule l’utilisation par appel pour une trace, avec agrégation des descendants. ## OpenAPI ````yaml /fr/weave/reference/service-api/openapi.json post /trace/usage openapi: 3.1.0 info: title: FastAPI version: 0.1.0 servers: [] security: [] paths: /trace/usage: post: tags: - Calls summary: Utilisation de la trace description: >- Calcule l’utilisation par appel pour une trace, avec agrégation des descendants. operationId: trace_usage_trace_usage_post requestBody: content: application/json: schema: $ref: '#/components/schemas/TraceUsageReq' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/TraceUsageRes' description: Réponse réussie '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Erreur de validation security: - HTTPBasic: [] - HTTPBearer: [] components: schemas: TraceUsageReq: additionalProperties: false description: >- 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. properties: filter: anyOf: - $ref: '#/components/schemas/CallsFilter' - type: 'null' description: >- Filtre pour sélectionner les appels. Utilisez généralement `trace_ids` pour obtenir tous les appels d’une trace. include_costs: default: false description: >- Si la valeur est true, inclure les calculs de coût dans l’Utilisation. title: Include Costs type: boolean limit: default: 10000 description: >- Nombre maximal d’appels à traiter. Sert de limite de sécurité pour éviter une utilisation de la mémoire sans borne. title: Limit type: integer project_id: title: Project Id type: string query: anyOf: - $ref: '#/components/schemas/Query' - type: 'null' description: Conditions de requête supplémentaires pour filtrer les appels. required: - project_id title: TraceUsageReq type: object TraceUsageRes: description: >- Réponse contenant les métriques d’Utilisation par appel (chacune inclut les contributions des descendants). properties: call_usage: additionalProperties: additionalProperties: $ref: '#/components/schemas/LLMAggregatedUsage' type: object title: Call Usage type: object unfinished_call_ids: items: type: string title: Unfinished Call Ids type: array title: TraceUsageRes type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object CallsFilter: additionalProperties: false properties: call_ids: anyOf: - items: type: string type: array - type: 'null' title: Call Ids input_refs: anyOf: - items: type: string type: array - type: 'null' title: Input Refs op_names: anyOf: - items: type: string type: array - type: 'null' title: Op Names output_refs: anyOf: - items: type: string type: array - type: 'null' title: Output Refs parent_ids: anyOf: - items: type: string type: array - type: 'null' title: Parent Ids thread_ids: anyOf: - items: type: string type: array - type: 'null' title: Thread Ids trace_ids: anyOf: - items: type: string type: array - type: 'null' title: Trace Ids trace_roots_only: anyOf: - type: boolean - type: 'null' title: Trace Roots Only turn_ids: anyOf: - items: type: string type: array - type: 'null' title: Turn Ids wb_run_ids: anyOf: - items: type: string type: array - type: 'null' title: Wb Run Ids wb_user_ids: anyOf: - items: type: string type: array - type: 'null' title: Wb User Ids title: CallsFilter type: object Query: additionalProperties: false properties: $expr: anyOf: - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $Expr required: - $expr title: Query type: object LLMAggregatedUsage: description: Métriques d'utilisation agrégées pour un LLM donné. properties: cache_creation_input_tokens: default: 0 title: Cache Creation Input Tokens type: integer cache_creation_input_tokens_total_cost: anyOf: - type: number - type: 'null' title: Cache Creation Input Tokens Total Cost cache_read_input_tokens: default: 0 title: Cache Read Input Tokens type: integer cache_read_input_tokens_total_cost: anyOf: - type: number - type: 'null' title: Cache Read Input Tokens Total Cost completion_tokens: default: 0 title: Completion Tokens type: integer completion_tokens_total_cost: anyOf: - type: number - type: 'null' title: Completion Tokens Total Cost prompt_tokens: default: 0 title: Prompt Tokens type: integer prompt_tokens_total_cost: anyOf: - type: number - type: 'null' title: Prompt Tokens Total Cost requests: default: 0 title: Requests type: integer total_tokens: default: 0 title: Total Tokens type: integer title: LLMAggregatedUsage type: object ValidationError: properties: loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object AndOperation: description: |- ET logique. Toutes les conditions doivent être évaluées à true. Exemple : ``` { "$and": [ {"$eq": [{"$getField": "op_name"}, {"$literal": "predict"}]}, {"$gt": [{"$getField": "summary.usage.tokens"}, {"$literal": 1000}]} ] } ``` properties: $and: items: anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $And type: array required: - $and title: AndOperation type: object OrOperation: description: "OU logique. Au moins une condition doit être vraie.\n\nExemple\_:\n ```\n {\n \"$or\": [\n {\"$eq\": [{\"$getField\": \"op_name\"}, {\"$literal\": \"a\"}]},\n {\"$eq\": [{\"$getField\": \"op_name\"}, {\"$literal\": \"b\"}]}\n ]\n }\n ```" properties: $or: items: anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $Or type: array required: - $or title: OrOperation type: object NotOperation: description: "NON logique. Inverse la condition.\n\nExemple\_:\n ```\n {\n \"$not\": [\n {\"$eq\": [{\"$getField\": \"op_name\"}, {\"$literal\": \"debug\"}]}\n ]\n }\n ```" properties: $not: maxItems: 1 minItems: 1 prefixItems: - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $Not type: array required: - $not title: NotOperation type: object EqOperation: description: "Vérifie l'égalité entre deux opérandes.\n\nExemple\_:\n ```\n {\n \"$eq\": [{\"$getField\": \"op_name\"}, {\"$literal\": \"predict\"}]\n }\n ```" properties: $eq: maxItems: 2 minItems: 2 prefixItems: - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $Eq type: array required: - $eq title: EqOperation type: object GtOperation: description: "Comparaison «\_supérieur à\_».\n\nExemple\_:\n ```\n {\n \"$gt\": [{\"$getField\": \"summary.usage.tokens\"}, {\"$literal\": 100}]\n }\n ```" properties: $gt: maxItems: 2 minItems: 2 prefixItems: - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $Gt type: array required: - $gt title: GtOperation type: object LtOperation: description: "Comparaison «\_inférieur à\_».\n\nExemple\_:\n ```\n {\n \"$lt\": [{\"$getField\": \"summary.usage.tokens\"}, {\"$literal\": 100}]\n }\n ```" properties: $lt: maxItems: 2 minItems: 2 prefixItems: - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $Lt type: array required: - $lt title: LtOperation type: object GteOperation: description: "Comparaison «\_supérieur ou égal à\_».\n\nExemple\_:\n ```\n {\n \"$gte\": [{\"$getField\": \"summary.usage.tokens\"}, {\"$literal\": 100}]\n }\n ```" properties: $gte: maxItems: 2 minItems: 2 prefixItems: - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $Gte type: array required: - $gte title: GteOperation type: object LteOperation: description: "Comparaison inférieure ou égale.\n\nExemple\_:\n ```\n {\n \"$lte\": [{\"$getField\": \"summary.usage.tokens\"}, {\"$literal\": 100}]\n }\n ```" properties: $lte: maxItems: 2 minItems: 2 prefixItems: - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: $Lte type: array required: - $lte title: LteOperation type: object InOperation: description: "Vérification d'appartenance.\n\nRenvoie true si l'opérande de gauche figure dans la liste fournie comme second opérande.\n\nExemple\_:\n ```\n {\n \"$in\": [\n {\"$getField\": \"op_name\"},\n [{\"$literal\": \"predict\"}, {\"$literal\": \"generate\"}]\n ]\n }\n ```" properties: $in: maxItems: 2 minItems: 2 prefixItems: - anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' - items: anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' type: array title: $In type: array required: - $in title: InOperation type: object ContainsOperation: description: "Correspondance de sous-chaîne insensible à la casse.\n\nNe fait pas partie de MongoDB. Ajout spécifique à Weave.\n\nExemple\_:\n ```\n {\n \"$contains\": {\n \"input\": {\"$getField\": \"display_name\"},\n \"substr\": {\"$literal\": \"llm\"},\n \"case_insensitive\": true\n }\n }\n ```" properties: $contains: $ref: '#/components/schemas/ContainsSpec' required: - $contains title: ContainsOperation type: object LiteralOperation: description: "Représente une valeur constante dans le langage de requête.\n\nIl peut s'agir de n'importe quelle valeur standard sérialisable en JSON.\n\nExemple\_:\n ```\n {\"$literal\": \"predict\"}\n ```" properties: $literal: anyOf: - type: string - type: integer - type: number - type: boolean - additionalProperties: $ref: '#/components/schemas/LiteralOperation' type: object - items: $ref: '#/components/schemas/LiteralOperation' type: array - type: 'null' title: $Literal required: - $literal title: LiteralOperation type: object GetFieldOperator: description: "Accède à un champ de l'appel tracé.\n\nPrend en charge la notation par points pour l'accès aux champs imbriqués, par ex. `summary.usage.tokens`.\n\nFonctionne uniquement avec les champs présents dans `CallSchema`, notamment\_:\n- Les champs de premier niveau comme `op_name`, `trace_id`, `started_at`\n- Les champs imbriqués comme `inputs.input_name`, `summary.usage.tokens`, etc.\n\nExemple\_:\n ```\n {\"$getField\": \"op_name\"}\n ```" properties: $getField: title: $Getfield type: string required: - $getField title: GetFieldOperator type: object ConvertOperation: description: "Convertit la valeur d'entrée dans un type spécifique (par ex. `int`, `bool`, `string`).\n\nExemple\_:\n ```\n {\n \"$convert\": {\n \"input\": {\"$getField\": \"inputs.value\"},\n \"to\": \"int\"\n }\n }\n ```" properties: $convert: $ref: '#/components/schemas/ConvertSpec' required: - $convert title: ConvertOperation type: object ContainsSpec: description: "Spécification de l’opération `$contains`.\n\n- `input`\_: la chaîne à rechercher.\n- `substr`\_: la sous-chaîne à rechercher.\n- `case_insensitive`\_: si la valeur est true, la correspondance est insensible à la casse." properties: case_insensitive: anyOf: - type: boolean - type: 'null' default: false title: Case Insensitive input: anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: Input substr: anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: Substr required: - input - substr title: ContainsSpec type: object ConvertSpec: description: "Spécifie les détails de conversion pour `$convert`.\n\n- `input`\_: l'opérande à convertir.\n- `to`\_: le type de destination." properties: input: anyOf: - $ref: '#/components/schemas/LiteralOperation' - $ref: '#/components/schemas/GetFieldOperator' - $ref: '#/components/schemas/ConvertOperation' - $ref: '#/components/schemas/AndOperation' - $ref: '#/components/schemas/OrOperation' - $ref: '#/components/schemas/NotOperation' - $ref: '#/components/schemas/EqOperation' - $ref: '#/components/schemas/GtOperation' - $ref: '#/components/schemas/LtOperation' - $ref: '#/components/schemas/GteOperation' - $ref: '#/components/schemas/LteOperation' - $ref: '#/components/schemas/InOperation' - $ref: '#/components/schemas/ContainsOperation' title: Input to: enum: - double - string - int - bool - exists title: To type: string required: - input - to title: ConvertSpec type: object securitySchemes: HTTPBasic: scheme: basic type: http HTTPBearer: scheme: bearer type: http ````