プロジェクト内のログをクエリします。この操作を使用して、プロジェクトレベルでログをクエリできます。
操作説明
注意事項
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 へのアクセスの承認」をご参照ください。
ログのクエリに必要な情報が取得されていること。この情報には、ログが属するプロジェクトの名前とプロジェクトのリージョンが含まれます。詳細については、「プロジェクトの管理」をご参照ください。
ログをクエリする前にインデックスが設定されていること。詳細については、「インデックスの作成」をご参照ください。
Simple Log Service を使用してログをクエリする際には制限があります。制限に基づいてクエリ文とクエリ時間範囲を指定することを推奨します。詳細については、「ログ検索の概要」および「ログ分析の概要」をご参照ください。
`query` には標準 SQL 文を設定する必要があります。
SQL 文の `FROM` 句で Logstore を指定する必要があります。Logstore は SQL テーブルとして使用できます。
SQL 文では、`__date__` または `__time__` パラメーターを使用して時間範囲を指定する必要があります。`__date__` パラメーターの値はタイムスタンプです。`__time__` パラメーターの値は整数で、単位は秒です。
認証リソース
次の表に、この操作に必要な権限付与情報を示します。この情報を RAM ポリシーの Action 要素に追加して、RAM ユーザーまたは RAM ロールにこの操作を呼び出す権限を付与できます。
| Action | リソース |
log:GetProjectLogs | acs:log:{#regionId}:{#accountId}:project/{#ProjectName} |
今すぐお試しください
テスト
RAM 認証
リクエスト構文
GET /logs HTTP/1.1リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| project |
string |
必須 |
プロジェクトの名前。 |
ali-test-project |
| query |
string |
必須 |
標準 SQL 文。この例では、SQL 文は `nginx-moni` という名前の Logstore で、2022-03-01 10:41:40 から 2022-03-01 10:56:40 までのページビュー (PV) 数をクエリします。 |
SELECT COUNT(*) as pv FROM nginx-moni where __time__ > 1646102500 and __time__ < 1646103400 |
| powerSql |
boolean |
任意 |
専用 SQL 機能を有効にするかどうかを指定します。詳細については、「専用 SQL の有効化」をご参照ください。有効な値は次のとおりです。
`powerSql` または query パラメーターを使用して専用 SQL を設定できます。 |
false |
リクエスト例
GET /logs?query=SELECT COUNT(*) as pv FROM nginx-moni where time > 1646102500 and time < 1646103400&powerSql=false HTTP/1.1 Host:ali-test-project.ch-hangzhou.log.aliyuncs.com Content-Type:application/json
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
array |
返されるログ。 |
||
|
object |
返されるログ。 |
[ { "__time__" : 1409529660, "__source__" : "192.168.1.100", "Key1" : "error", "Key2" : "Value2" }, { "__time__" : 1409529680, "__source__" : "192.168.1.100", "Key3" : "error", "Key4" : "Value4" } ] |
|
|
string |
返されるログ。 |
[ { "__time__" : 1409529660, "__source__" : "192.168.1.100", "Key1" : "error", "Key2" : "Value2" }, { "__time__" : 1409529680, "__source__" : "192.168.1.100", "Key3" : "error", "Key4" : "Value4" } ] |
例
成功レスポンス
JSONJSON
[
{
"key": "[ { \"__time__\" : 1409529660, \"__source__\" : \"192.168.1.100\", \"Key1\" : \"error\", \"Key2\" : \"Value2\" }, { \"__time__\" : 1409529680, \"__source__\" : \"192.168.1.100\", \"Key3\" : \"error\", \"Key4\" : \"Value4\" } ]"
}
]エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。