すべてのプロダクト
Search

このプロダクト

    :GetContextLogs

    ドキュメントセンター

    :GetContextLogs

    最終更新日:Dec 23, 2025

    指定されたログのコンテキストログをクエリします。

    操作説明

    • 開始ログとしてログを指定できます。コンテキストクエリの時間範囲は、開始ログの生成時刻の前後 1 日です。

    • Host は、プロジェクト名と Simple Log Service のエンドポイントで構成されます。Host でプロジェクトを指定する必要があります。

    • AccessKey ペアを作成して取得します。詳細については、「AccessKey ペア」をご参照ください。

    Alibaba Cloud アカウントの AccessKey ペアは、すべての API 操作に対する権限を持っています。これらの資格情報を使用して Simple Log Service で操作を実行することは、高リスクな操作です。API 操作の呼び出しや定期的な O&M の実行には、Resource Access Management (RAM) ユーザーを使用することを推奨します。RAM ユーザーを作成するには、RAM コンソールにログインします。RAM ユーザーが Simple Log Service リソースに対する管理権限を持っていることを確認してください。詳細については、「RAM ユーザーの作成と Simple Log Service へのアクセスの承認」をご参照ください。

    • ログのクエリに必要な情報を取得します。この情報には、ログが属するプロジェクトの名前、プロジェクトのリージョン、ログが属する Logstore の名前が含まれます。詳細については、「プロジェクトの管理」および「Logstore の管理」をご参照ください。

    • ログをクエリする前にインデックスを設定します。詳細については、「インデックスの作成」をご参照ください。

    • ログをクエリする前に、`pack_id` および `pack_meta` フィールドの値を取得します。これらのフィールドは内部フィールドであり、Simple Log Service コンソールのブラウザのデバッグ機能を使用して値を取得できます。

    認証リソース

    この操作に必要な権限付与情報を次の表に示します。RAM ユーザーまたは RAM ロールにこの操作を呼び出す権限を付与するには、この情報を RAM ポリシーステートメントの Action 要素に追加します。

    アクションリソース
    log:GetLogStoreContextLogsacs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}

    今すぐお試しください

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

    テスト

    RAM 認証

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

    リクエスト構文

    GET /logstores/{logstore}?type=context_log HTTP/1.1

    パスパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    logstore

    string

    必須

    Logstore の名前です。

    test-logstore

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    project

    string

    必須

    プロジェクトの名前です。

    ali-test-project
    pack_id

    string

    必須

    開始ログが属するロググループの一意の識別子です。

    85C897C740352DC6-808
    pack_meta

    string

    必須

    ロググループ内の開始ログの一意のコンテキスト識別子です。

    2|MTY1NTcwNTUzODY5MTY0MDk1Mg==|3|0
    back_lines

    integer

    必須

    開始ログの生成時刻より前に生成された、取得したいログの数です。有効値：(0,100]。

    10
    forward_lines

    integer

    必須

    開始ログの生成時刻より後に生成された、取得したいログの数です。有効値：(0,100]。

    10

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスのスキーマです。

    total_lines

    integer

    返されるログの総数です。このログには、リクエストで指定された開始ログが含まれます。

    201
    back_lines

    integer

    開始ログの生成時刻より前に生成されたログの数です。

    100
    forward_lines

    integer

    開始ログの生成時刻より後に生成されたログの数です。

    100
    progress

    string

    クエリと分析の結果が完全であるかどうかを示します。有効値：

    • Complete：クエリは成功し、完全なクエリと分析の結果が返されます。

    • Incomplete：クエリは成功しましたが、クエリと分析の結果は不完全です。完全な結果を取得するには、リクエストを再度実行する必要があります。

    Complete
    logs

    array<object>

    返されるログです。

    object

    返されるログです。ログはコンテキスト順に並べられています。指定された開始ログに基づいてコンテキストログが見つからない場合、このパラメーターは空になります。

    { "__index_number__": "-100", "__tag__:__pack_id__": "895CEA449A52FE-8c8", "__pack_meta__": "0|MTU1OTI4NTExMjg3NTQ2NDU1OA==|4|1"}

    `logs` パラメーターには、ログの内容と、キーと値のペアの形式でフォーマットされた次のフィールドが含まれます。

    フィールドタイプ例説明
    __index_number__String-100コンテキスト内でのログの位置です。負の値は、ログが開始ログの生成時刻より前に生成されたことを示します。値 0 は、ログが開始ログであることを示します。正の値は、ログが開始ログの生成時刻より後に生成されたことを示します。たとえば、値 -100 は、ログが開始ログの生成時刻より前の 100 番目のログであることを示します。
    __tag__:__pack_id__String895CEA449A52FE-8c8ログが属するロググループの一意の識別子です。この識別子は、リクエストで pack_id パラメーターの値として使用できます。
    __pack_meta__String0|MTU1OTI4NTExMjg3NTQ2NDU1OA==|4|1ロググループ内のログの一意のコンテキスト識別子です。

    例

    成功レスポンス

    JSONJSON

    {
  "total_lines": 201,
  "back_lines": 100,
  "forward_lines": 100,
  "progress": "Complete",
  "logs": [
    {
      "__index_number__": "-100",
      "__tag__:__pack_id__": "895CEA449A52FE-8c8",
      "__pack_meta__": "0|MTU1OTI4NTExMjg3NTQ2NDU1OA==|4|1"
    }
  ]
}

    エラーコード

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

    変更履歴

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