すべてのプロダクト
Search

このプロダクト

    :SearchTraces

    ドキュメントセンター

    :SearchTraces

    最終更新日:Feb 02, 2026

    SearchTraces 操作は、トレースのリストを照会します。時間、アプリケーション名、IP アドレス、スパン名、タグによってトレースをフィルターできます。

    今すぐお試しください

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

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    xtrace:SearchTrace

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    StartTime

    integer

    必須

    開始時刻。値はミリ秒 (ms) 単位のタイムスタンプです。

    1714298814000
    EndTime

    integer

    必須

    終了時刻。値はミリ秒 (ms) 単位のタイムスタンプです。

    1714385214000
    RegionId

    string

    必須

    リージョン ID。

    cn-beijing
    ServiceName

    string

    任意

    マイクロサービスの名前。アプリケーション名とも呼ばれます。

    service 1
    OperationName

    string

    任意

    スパン名。これは、トレースポイントまたはイベントトラッキングポイントの名前です。

    /api
    MinDuration

    integer

    任意

    トレースの最小期間。単位：ミリ秒 (ms)。たとえば、値が 200 の場合、200 ms を超える期間のトレースが返されます。

    2
    AppType

    string

    任意

    アプリケーションタイプ。有効な値は Empty または XTRACE です。

    • Empty (推奨)：XTRACE と Application Real-Time Monitoring Service (ARMS) の両方からトレースを照会します。

    • XTRACE：XTRACE からのみトレースを照会します。

    XTRACE
    PageNumber

    integer

    任意

    ページ番号。たとえば、値が 5 の場合は 5 ページ目を指定します。

    1
    PageSize

    integer

    任意

    各ページで返されるエントリ数。

    20
    Reverse

    boolean

    任意

    結果を時系列順または逆時系列順にソートするかどうかを指定します。デフォルト値は false です。有効な値：

    • true：逆時系列順。

    • false：時系列順。

    false
    ServiceIp

    string

    任意

    スパンが存在するホストの IP アドレス。

    192.163.XXX.XXX
    Tag

    array<object>

    任意

    タグのリスト。

    object

    任意

    タグのリスト。

    Key

    string

    任意

    タグキー。

    http.status_cod
    Value

    string

    任意

    タグ値。

    200
    StatusCode

    string

    任意

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

    1E2B6A4C-6B83-4062-8B6F-AEEC1F******
    PageBean

    object

    返されたデータのページネーション情報。

    PageSize

    integer

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

    20
    PageNumber

    integer

    ページ番号。

    1
    TotalCount

    integer

    エントリの総数。

    500
    TraceInfos

    object

    TraceInfo

    array<object>

    返されたトレースに関する情報。

    array<object>

    返されたトレースに関する情報。

    OperationName

    string

    スパン名。

    /api
    ServiceIp

    string

    スパンが存在するホストの IP アドレスまたはホスト名。

    192.163.XXX.XXX
    Duration

    integer

    期間。単位：ミリ秒 (ms)。

    500
    Timestamp

    integer

    スパンが生成された時刻。単位：ミリ秒 (ms)。

    1714306014000
    ServiceName

    string

    マイクロサービスの名前。アプリケーション名とも呼ばれます。

    service1
    TraceID

    string

    トレース ID。

    1c6881aab841******
    TagMap

    object

    タグ情報。

    {"env":"dev"}
    StatusCode

    integer

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "1E2B6A4C-6B83-4062-8B6F-AEEC1F******",
  "PageBean": {
    "PageSize": 20,
    "PageNumber": 1,
    "TotalCount": 500,
    "TraceInfos": {
      "TraceInfo": [
        {
          "OperationName": "/api",
          "ServiceIp": "192.163.XXX.XXX",
          "Duration": 500,
          "Timestamp": 1714306014000,
          "ServiceName": "service1",
          "TraceID": "1c6881aab841******",
          "TagMap": {
            "env": "dev"
          },
          "StatusCode": 0
        }
      ]
    }
  }
}

    エラーコード

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

    変更履歴

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