すべてのプロダクト
Search
ドキュメントセンター

:GetLogsV2

最終更新日:Nov 07, 2025

プロジェクト内の指定された Logstore から生ログをクエリします。応答には、指定された時間範囲の生ログが含まれ、転送のために圧縮されます。

操作説明

  • Simple Log Service ソフトウェア開発キット (SDK) は、Go、Java、Python でのみ利用可能です。ただし、すべての OpenAPI 操作を直接呼び出すことができます。

  • この操作を呼び出すときは、圧縮メソッドを指定する必要があります。利用可能な圧縮アルゴリズムは、プログラミング言語によって異なります。詳細については、「Accept-Encoding リクエストパラメーター」をご参照ください。

  • 詳細については、「GetLogs」をご参照ください。

権限

次の表に、この API 操作の権限付与を示します。RAM ユーザーまたは RAM ロールにこの操作を呼び出す権限を付与するには、Resource Access Management (RAM) ポリシーステートメントに操作を追加します。

操作権限付与ポリシーのリソース
log:GetLogStoreLogsacs:log:{#regionId}:{#accountId}:project/{#ProjectName}

今すぐお試しください

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

テスト

RAM 認証

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

リクエスト構文

POST /logstores/{logstore}/logs HTTP/1.1

パスパラメータ

パラメーター

必須 / 任意

説明

logstore

string

必須

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

test-logstore

リクエストパラメーター

パラメーター

必須 / 任意

説明

Accept-Encoding

string

必須

Logstore の名前です。

列挙値:

  • lz4 :
    lz4
  • gzip :
    gzip

lz4

body

object

任意

圧縮方式です。

  • Java、Python、Go は lz4 と gzip の展開をサポートしています。

  • PHP、JavaScript、C# は gzip の展開のみをサポートしています。

from

integer

必須

クエリする時間範囲の開始時刻。値は、ログが書き込まれたときに指定されたログ時間です。 時間範囲は、左閉右開区間です。これは、範囲が開始時刻を含み、終了時刻を含まないことを意味します。`from` と `to` の値が同じ場合、間隔は無効になり、エラーが返されます。 値は、1970 年 1 月 1 日 00:00:00 UTC からの秒数を表す UNIX タイムスタンプです。

1627268185

to

integer

必須

クエリする時間範囲の終了時刻。値は、ログが書き込まれたときに指定されたログ時間です。 時間範囲は、左閉右開区間です。これは、範囲が開始時刻を含み、終了時刻を含まないことを意味します。`from` と `to` の値が同じ場合、間隔は無効になり、エラーが返されます。 値は、1970 年 1 月 1 日 00:00:00 UTC からの秒数を表す UNIX タイムスタンプです。

1627268185

line

integer

任意

返すログの最大数。このパラメーターは、`query` パラメーターに検索文が含まれている場合にのみ有効です。値は 0 から 100 の間でなければなりません。デフォルト値は 100 です。

100

offset

integer

任意

クエリを開始する行番号。このパラメーターは、`query` パラメーターに検索文が含まれている場合にのみ有効です。デフォルト値は 0 です。

0

reverse

boolean

任意

タイムスタンプの降順でログを返すかどうかを指定します。精度は分レベルです。 true: タイムスタンプの降順でログを返します。 false (デフォルト): タイムスタンプの昇順でログを返します。 注 `query` パラメーターに検索文が含まれている場合、このパラメーターは有効であり、ソート順を指定します。`query` パラメーターに分析文が含まれている場合、このパラメーターは無効です。ソート順は、分析文の `ORDER BY` 句で指定されます。`ORDER BY asc` (デフォルト) はログを昇順にソートします。`ORDER BY desc` はログを降順にソートします。

false

powerSql

boolean

任意

拡張 SQL を有効にするかどうかを指定します。デフォルト値は false です。

false

session

string

任意

クエリパラメーター。

mode=scan

topic

string

任意

ログの Topic。デフォルト値は二重引用符 ("") です。

""

query

string

任意

検索文または分析文。詳細については、「[クエリの概要](~~43772~~)」および「[分析の概要](~~53608~~)」をご参照ください。 排他的 SQL 機能を使用するには、`query` パラメーターの分析文に `set session parallel_sql=true;` を追加します。例: `* | set session parallel_sql=true; select count(*) as pv`。 注: `query` パラメーターに分析文 (SQL 文) が含まれている場合、`line` および `offset` パラメーターは無効です。これらを 0 に設定してください。ページングには SQL 文の `LIMIT` 句を使用します。詳細については、「クエリと分析結果のページ分割」をご参照ください。

status: 401 | SELECT remote_addr,COUNT(*) as pv GROUP by remote_addr ORDER by pv desc limit 5

forward

boolean

任意

スキャンまたはフレーズクエリの場合、順方向または逆方向にページングするかどうかを指定します。

false

highlight

boolean

任意

結果をハイライト表示するかどうかを指定します。

false

レスポンスフィールド

フィールド

説明

object

返されたデータです。

meta

object

返されたデータのメタデータです。

progress

string

クエリの進行状況。有効な値:

  • Complete: クエリは完了しており、返された結果は完全です。

  • Incomplete: クエリは完了していますが、返された結果は不完全です。完全な結果を得るには、リクエストを再度送信する必要があります。

Complete

aggQuery

string

クエリ文の縦棒 (|) に続く SQL 部分です。

select *

whereQuery

string

クエリ文の縦棒 (|) より前の部分です。

*

hasSQL

boolean

クエリが SQL クエリであるかどうかを示します。

false

processedRows

integer

クエリで処理された行数です。

10000

elapsedMillisecond

integer

クエリにかかった時間 (ミリ秒単位)。

5

cpuSec

number

排他的 SQL のコア時間です。

0.002

cpuCores

integer

使用された CPU コアの数です。

3

keys

array

クエリ結果のすべてのキーです。

string

キーです。

key

terms

array<object>

クエリ文のすべての term です。

object

term です。

{term=*, key=}

limited

integer

返されたエントリの数。このパラメーターは、SQL 文に LIMIT 句が含まれていない場合に返されます。

100

mode

integer

クエリモード。有効な値: 0: 通常のクエリ (SQL クエリを含む)。 1: フレーズクエリ。 2: SCAN クエリ。 3: SCAN SQL クエリ。

0

phraseQueryInfo

object

フレーズクエリに関する情報です。

scanAll

boolean

すべてのログがスキャンされたかどうかを示します。

true

beginOffset

integer

インデックスフィルタリング後のスキャン結果の開始オフセットです。

0

endOffset

integer

インデックスフィルタリング後のスキャン結果の終了オフセットです。

0

endTime

integer

インデックスフィルタリング後のスキャン結果の終了時刻です。

1

scanBytes

integer

スキャンクエリでスキャンされたデータの量。単位: バイト。

1024

highlights

array

ハイライト表示された内容です。

array

ハイライト表示された内容です。

LogContent

ハイライト表示されたログの内容です。

count

integer

このクエリで返されたログエントリの数です。

1

processedBytes

integer

クエリで処理されたログの量。単位: バイト。

10000

isAccurate

boolean

クエリが秒単位で正確かどうかを示します。

true

columnTypes

array

列の型です。

string

型です。

long

telementryType

string

観測可能なデータの種類です。

None

data

array<object>

クエリ結果です。

object

返されたデータです。

string

返されたデータです。

{'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}

成功レスポンス

JSONJSON

{
  "meta": {
    "progress": "Complete",
    "aggQuery": "select *",
    "whereQuery": "*",
    "hasSQL": false,
    "processedRows": 10000,
    "elapsedMillisecond": 5,
    "cpuSec": 0.002,
    "cpuCores": 3,
    "keys": [
      "key"
    ],
    "terms": [
      {
        "test": "test",
        "test2": 1
      }
    ],
    "limited": 100,
    "mode": 0,
    "phraseQueryInfo": {
      "scanAll": true,
      "beginOffset": 0,
      "endOffset": 0,
      "endTime": 1
    },
    "scanBytes": 1024,
    "highlights": [
      [
        {
          "Key": "key-test",
          "Value": "value-test"
        }
      ]
    ],
    "count": 1,
    "processedBytes": 10000,
    "isAccurate": true,
    "columnTypes": [
      "long"
    ],
    "telementryType": "None"
  },
  "data": [
    {
      "key": "{'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}"
    }
  ]
}

エラーコード

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

変更履歴

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