すべてのプロダクト
Search

このプロダクト

    Application Real-Time Monitoring Service:SearchTraces

    ドキュメントセンター

    Application Real-Time Monitoring Service:SearchTraces

    最終更新日:Apr 10, 2026

    時間、アプリケーション名、IP アドレス、スパン名、タグでトレースをクエリします。

    操作説明

    説明

    この操作は、一度に最大 100 件のデータエントリを返すことができます。 既存のすべてのトレースをクエリする場合は、SearchTracesByPage 操作を呼び出すことを推奨します。 詳細については、「SearchTracesByPage」をご参照ください。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    StartTime

    integer

    必須

    クエリする時間範囲の開始時刻。 単位：ミリ秒。

    1595174400000
    EndTime

    integer

    必須

    クエリする時間範囲の終了時刻。 単位：ミリ秒。

    1595210400000
    RegionId

    string

    必須

    リージョン ID。

    cn-hangzhou
    ServiceName

    string

    任意

    アプリケーション名。

    arms-k8s-demo-subcomponent
    OperationName

    string

    任意

    トレースされたスパンの名前。

    /demo/queryNotExistDB/11
    MinDuration

    integer

    任意

    トレースが消費する最小時間。 単位：ミリ秒。

    2
    Reverse

    boolean

    任意

    クエリ結果を時系列順にソートするか、逆時系列順にソートするかを指定します。 デフォルト値：false。

    • true：クエリ結果を逆時系列順にソートします。

    • false：クエリ結果を時系列順にソートします。

    false
    ServiceIp

    string

    任意

    アプリケーションが存在するホストの IP アドレス。

    172.20.XX.XX
    Pid

    string

    任意

    アプリケーション ID。

    b590lhguqs@9781be0f44dXXXX
    Tag

    array<object>

    任意

    タグのリスト。

    object

    任意

    Key

    string

    任意

    タグキー。 次のシステムプリセットフィールドが提供されています：

    • serverApp：サーバーアプリケーションの名前。

    • clientApp：クライアントアプリケーションの名前。

    • service：操作の名前。

    • rpc：呼び出しのタイプ。

    • msOfSpan：持続時間が特定の値を超えています。

    • clientIp：クライアントの IP アドレス。

    • serverIp：サーバーの IP アドレス。

    • isError：呼び出しが異常かどうかを指定します。

    • hasTprof：スレッドプロファイリングのみを含みます。

    http.status_code
    Value

    string

    任意

    タグの値。

    200
    ExclusionFilters

    array<object>

    任意

    フィルター条件。

    object

    任意

    Key

    string

    任意

    クエリ結果のフィルターに使用されるキー。

    http.status_code
    Value

    string

    任意

    クエリ結果のフィルターに使用されるキーの値。

    404

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

    4C518054-852F-4023-ABC1-4AF95FF7****
    TraceInfos

    array<object>

    返されたトレースの詳細。

    object

    OperationName

    string

    トレースされたスパンの名前。

    get***
    ServiceIp

    string

    アプリケーションが存在するホストの IP アドレス。

    172.20.**.**
    Duration

    integer

    トレースによって消費された時間。 単位：ミリ秒。

    6
    Timestamp

    integer

    タイムスタンプ。

    1595174436993
    ServiceName

    string

    アプリケーション名。

    arms-k8s-demo-subcomponent
    TraceID

    string

    トレース ID。

    ac1400a115951744369937024d****
    SpanID

    string

    スパン ID。 ARMS コンソールの [トレースエクスプローラー] ページから取得できます。

    be3d6dcf5750e***

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "4C518054-852F-4023-ABC1-4AF95FF7****",
  "TraceInfos": [
    {
      "OperationName": "get***",
      "ServiceIp": "172.20.**.**",
      "Duration": 6,
      "Timestamp": 1595174436993,
      "ServiceName": "arms-k8s-demo-subcomponent",
      "TraceID": "ac1400a115951744369937024d****",
      "SpanID": "be3d6dcf5750e***"
    }
  ]
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。