すべてのプロダクト
Search

このプロダクト

    Application Real-Time Monitoring Service:SearchTracesByPage

    ドキュメントセンター

    Application Real-Time Monitoring Service:SearchTracesByPage

    最終更新日:Apr 10, 2026

    ページ単位でトレースをクエリします。時間範囲、アプリケーション名、IP アドレス、スパン名、またはタグでトレースをクエリできます。

    今すぐお試しください

    この 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
    PageNumber

    integer

    任意

    返すページ番号。

    1
    PageSize

    integer

    任意

    各ページで返すエントリ数。最大値：100。

    5
    Pid

    string

    任意

    アプリケーション ID。

    b590lhguqs@9781be0f44dXXXX
    ExclusionFilters

    array<object>

    任意

    フィルター条件。

    object

    任意

    Key

    string

    任意

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

    http.status_code
    Value

    string

    任意

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

    404
    Tags

    array<object>

    任意

    タグのリスト。

    object

    任意

    Key

    string

    任意

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

    • traceId：トレースの ID。

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

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

    • service：インターフェイスの名前。

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

    • msOfSpan：持続時間が特定の時間を超える。

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

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

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

    http.status_code
    Value

    string

    任意

    タグの値。

    200
    IsError

    boolean

    任意

    異常な呼び出しのトレースを含めるかどうかを指定します。

    • true：いいえ

    • false (デフォルト)：はい

    false

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

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

    object

    返される構造体。

    PageNumber

    integer

    返されたページのページ番号。

    1
    PageSize

    integer

    ページごとに返されるエントリ数。

    5
    Total

    integer

    返されたエントリの総数。

    1601
    TraceInfos

    array<object>

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

    object

    OperationName

    string

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

    /demo/queryException/12
    ServiceIp

    string

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

    172.20.XX.XX
    Duration

    integer

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

    679
    Timestamp

    integer

    タイムスタンプ。

    1595174436994
    ServiceName

    string

    アプリケーション名。

    arms-k8s-demo-subcomponent
    TraceID

    string

    トレース ID。

    ac1400a115951744369947025d****
    SpanID

    string

    トレースのスパン ID。

    be3d6dcf5750e***

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "4C518054-852F-4023-ABC1-4AF95FF7****",
  "PageBean": {
    "PageNumber": 1,
    "PageSize": 5,
    "Total": 1601,
    "TraceInfos": [
      {
        "OperationName": "/demo/queryException/12",
        "ServiceIp": "172.20.XX.XX",
        "Duration": 679,
        "Timestamp": 1595174436994,
        "ServiceName": "arms-k8s-demo-subcomponent",
        "TraceID": "ac1400a115951744369947025d****",
        "SpanID": "be3d6dcf5750e***"
      }
    ]
  }
}

    エラーコード

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

    変更履歴

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