トレース使用量

子孫 call を含めて集計し、trace の call ごとの使用量を計算します。

POST /trace/usage

トレース使用量

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>"
  ]
}

承認

Authorization · string · header · 必須

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

ボディ

application/json

子孫のロールアップを含めて、trace の call ごとの使用量を計算するためのリクエストです。

この Endpoint は、trace 内の各 call の使用量メトリクスを返します。各 call のメトリクスには、その call 自身の使用量に加えて、すべての子孫の使用量の合計が含まれます。 call ごとにロールアップされたメトリクスを確認したい Trace view で使用してください。

注: 一致するすべての calls は、集約のためにメモリに読み込まれます。結果セットが非常に大きい場合 （>10k calls）は、より具体的なフィルターを使用するか、application レイヤーでページネーションを検討してください。

project_id · string · 必須

filter · CallsFilter · object

calls を選択するためのフィルター。通常は、trace 内のすべての calls を取得するために trace_ids を使用します。

Show child attributes

query · Query · object

calls をフィルタリングするための追加のクエリ条件。

Show child attributes

include_costs · boolean · デフォルト: false

true の場合、使用量にコスト計算を含めます。

limit · integer · デフォルト: 10000

処理する calls の最大数。際限のないメモリ使用を防ぐための安全上の上限として機能します。

レスポンス

200

application/json

成功レスポンス

call ごとの使用量メトリクスを含むレスポンス（各メトリクスには子孫の寄与を含みます）。

call_usage · Call Usage · object

Show child attributes

unfinished_call_ids · string[]