tencent cloud

Cloud Log Service

ドキュメントCloud Log Service操作ガイドログトピックの検索分析Elasticsearchインターフェース互換

Elasticsearchインターフェース互換

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-12 14:32:15
AI翻訳・品質チェック済み

操作シナリオ

Elasticsearchはオープンソースの分散検索・分析エンジンであり、CLSはその一部のインターフェースと互換性があります。ElasticsearchからCLSに移行する際、以前使用していたElasticsearchインターフェースがCLSの互換範囲内にある場合は、それらのインターフェースを引き続き使用できるため、移行の複雑さを軽減できます。
CLSの互換インターフェースはElasticsearch 7.10バージョンに基づいています。

前提条件

ログはインデックスを有効にして初めて対応するDSLを使用できます。詳細についてはインデックス設定をご参照ください。

アクセス方法

外部ネットワークアドレス：https://${region}.cls.tencentcs.com/elasticsearch/
内部ネットワークアドレス：https://${region}.cls.tencentyun.com/elasticsearch/
このうち${region}は地域略称です。ログトピックが存在する地域を使用してください。
インターフェースはBasic Authを使用して認証を行い、APIキーのSecretIdとSecretKeyをそれぞれusernameとpasswordとして使用します。
説明：
子アカウントを個別に作成し、そのアカウントのSecretIdおよびSecretKeyを使用することをお勧めします。そのアカウントには以下のインターフェース権限のみを付与してください。設定方法については子アカウント権限付与をご参照ください。
{
    "version": "2.0",
    "statement": [
        {
            "effect": "allow",
            "action": [
                "cls:SearchLog"
            ],
            "resource": [
                "*"
            ]
        }
    ]
}

互換インターフェース

Search API
GET /${topic_id}/_search
POST /${topic_id}/_search
このうち${topic_id}はログトピックIDであり、Elasticsearchのindexに相当します。ログトピックリストページで取得できます。

DSL互換

説明：
ログ時間範囲でデータをクエリする際は、Elasticsearchの@timestampフィールドの代わりに__TIMESTAMP__フィールドを使用してください。
クエリDSL
termおよびterms：指定されたフィールドはキー値インデックスを有効にする必要があります。
match_phrase：指定されたフィールドはキー値インデックスを有効にする必要があります。
range：指定されたフィールドはキー値インデックスを有効にする必要があります。
集計DSL
terms：指定されたフィールドにはキー値インデックスを追加し、統計を有効にする必要があります。
共通パラメータ
ページングと並べ替え：from、size、sort。sortに使用するフィールドにはキー値インデックスを追加し、統計を有効にする必要があります。
結果制御：track_total_hits。

例

説明：
例では、__TIMESTAMP__はログ時間であり、ミリ秒単位のUnixタイムスタンプです。rangeを使用してフィルタリングし、ログをクエリする時間範囲を表します。
2026-03-31 10:26:35～2026-03-31 10:41:35の時間範囲において、reqMethodがGETであるログをクエリします。
curl -X POST "https://ap-chongqing.cls.tencentcs.com/elasticsearch/58b9496c-c6c6-48b3-xxx-50824857a13c/_search" \\
  -H "Content-Type: application/json" \\
  -u AKIDBFvNbcOwLWTXXXXXXXXXXXXXXXXXXXXX:bx5zf6JI3wb18XXXXXXXXXXXXXXXXXXXXX \\
  -d '{
    "track_total_hits": true,
    "size": 10,
    "query": {
      "bool": {
        "filter": [
          { "match": { "reqMethod": "GET" } },
          { 
            "range": {
              "__TIMESTAMP__": { 
                "gte": 1774923995000,
                "lte": 1774924895000
              }
            }
          }
        ]
      }
    }
  }'
2026-03-31 10:26:35～2026-03-31 10:41:35の時間範囲において、ログ全文にキーワードUSERを含むログをクエリし、resHttpCodeに基づいてグループ化して集計します。
curl -X POST "https://ap-chongqing.cls.tencentcs.com/elasticsearch/58b9496c-c6c6-48b3-xxxx-50824857a13c/_search" \\
  -H "Content-Type: application/json" \\
  -u AKIDBFvNbcOwLWTXXXXXXXXXXXXXXXXXXXXX:bx5zf6JI3wb18XXXXXXXXXXXXXXXXXXXXX \\
  -d '{
    "query": {
      "bool": {
        "filter": [
          { 
            "multi_match": {
              "type": "best_fields",
              "query": "USER",
              "lenient": true
            }
          },
          { 
            "range": {
              "__TIMESTAMP__": { 
                "gte": 1774923995000,
                "lte": 1774924895000
              }
            }
          }
        ]
      }
    },
    "aggs": {
      "http_code_distribution": {
        "terms": {
          "field": "resHttpCode",
          "size": 100,
          "min_doc_count": 1
        }
      }
    }
  }'

前の記事へ: クエリ文のインテリジェント作成次の記事へ: 文法規則

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック

キーワードで検索
    Enter keywords to search documentation