メインコンテンツへスキップ
ElasticsearchクラスターをCloudThinkerに接続すると、エージェントがログの検索、オブザーバビリティデータの分析、インシデントの調査を行えるようになります。 Elasticsearchは、特定のインデックスおよびクラスター権限にスコープされたAPIキーで認証します。

​
前提条件

  • CloudThinkerから到達可能な Elasticsearch（7.x、8.x）、OpenSearch（1.x、2.x）、AWS OpenSearch Service、または Elastic Cloud クラスター。
  • APIキーを作成するための Kibana（Stack Management → Security → API Keys）または Elasticsearch API への管理者アクセス。
  • クラスターエンドポイントURL。

​
セットアップ

1

Kibanaを開く

Kibanaインスタンスにアクセスし、管理者権限でサインインします。
2

APIキーへ移動

Stack Management → Security → API Keys へ移動します。
3

APIキーを作成

Create API key をクリックし、次の情報を入力します:
  • Name: cloudthinker-readonly
4

権限を設定

読み取り専用アクセス用のロールディスクリプターを追加します（完全なJSONは必要な権限を参照）。最低限、クラスターに monitor、必要なインデックスパターンに read + view_index_metadata を付与してください。
5

生成してコピー

Create API key をクリックし、エンコードされたキーをすぐにコピーします。Elasticsearchはキーを再表示しません。
6

クラスターエンドポイントを確認

Elasticsearchエンドポイントをコピーします:
  • セルフホスト: https://elasticsearch.your-domain.com:9200
  • Elastic Cloud: デプロイ設定から確認
  • AWS OpenSearch: AWSコンソールのドメインエンドポイント
7

CloudThinkerで接続を追加

Connections → Elasticsearch に移動し、次の情報を入力します:
  • Cluster URL: Elasticsearchエンドポイント
  • API Key: コピーしたエンコード済みキー
  • Index patterns: アクセスするパターン（例: logs-*）
Connect をクリックします。CloudThinkerが認証情報を検証し、Connected ステータスを表示します。
APIキーは作成直後にコピーしてください。Elasticsearchはキーを再表示しないため、紛失した場合は新しいキーを作成する必要があります。

​
接続の詳細

フィールド説明例
ES_URLElasticsearchクラスターURLhttps://your-cluster.es.region.cloud.es.io:9243
ES_API_KEYBase64エンコードされたAPIキーVnVhQk...
設定する一般的なインデックスパターン:
パターンユースケース
logs-*アプリケーションログ
filebeat-*Filebeatで収集したログ
metricbeat-*インフラストラクチャメトリクス
apm-*アプリケーションパフォーマンスデータ
kubernetes-*Kubernetesクラスターログ

​
必要な権限

​
最小権限

{
  "cluster": ["monitor"],
  "indices": [
    {
      "names": ["logs-*", "metrics-*"],
      "privileges": ["read"]
    }
  ]
}

​
推奨

{
  "cluster": ["monitor", "read_ilm"],
  "indices": [
    {
      "names": ["*"],
      "privileges": ["read", "view_index_metadata"]
    }
  ]
}
CloudThinkerが必要とするインデックスパターンに対してのみ read 権限を付与してください。CloudThinkerのAPIキーに write やクラスター管理者権限を付与しないでください。

​
エージェント機能

接続後、エージェントは次のことができます:
機能説明
ログ検索アプリケーションおよびインフラストラクチャログを検索
エラー分析エラーパターンと異常を検出
インシデント調査サービス間でイベントを相関付け
メトリクスクエリ保存されたメトリクスデータをクエリ

​
接続を確認

@oliver search Elasticsearch for application errors in the last hour

​
プロンプト例

@oliver search logs for authentication failures in the last 24 hours
@alex find error patterns in application logs for the api-gateway service
@kai search for pod crash events in Kubernetes logs

​
トラブルシューティング

  • クラスターURLが正しく、CloudThinkerから到達可能であることを確認してください。
  • ファイアウォールルールがCloudThinkerのエグレスIPを許可しているか確認してください。
  • AWS OpenSearchの場合、パブリックアクセスを有効にするか、VPCエンドポイントを設定してください。
  • Elasticsearchが実行中でリクエストを受け付けていることを確認してください。
  • APIキーが正しく、期限切れになっていないか確認してください。
  • キーに必要なインデックスおよびクラスター権限があることを確認してください。
  • AWS OpenSearchの場合、IAMロールまたはアクセスポリシーが正しく設定されているか確認してください。
  • Stack Management → Security → API Keys に移動します。
  • 同じ権限で新しいキーを作成します。
  • CloudThinkerの接続設定でキーを更新します。
  • インデックスパターンがクラスター内の既存インデックスに一致しているか確認してください。
  • APIキーがそれらのインデックスに対して read 権限を持っているか確認してください。
  • インデックスにリクエストした時間範囲のデータが含まれていることを確認してください。

​
セキュリティ

  • 最小権限 — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
  • デフォルトで読み取り専用 — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
  • 認証情報のローテーション — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
  • オフボーディング時に失効 — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。
  • APIキーのローテーション — APIキーは90日ごとにローテーションし、キー作成時に有効期限を設定してください
  • インデックスの制限 — CloudThinkerが実際に必要とするインデックスパターンにキーを制限し、* へのアクセスを許可しないでください

​
関連情報

Oliver エージェント

セキュリティログ分析
https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/grafana.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=c1329049025cd3c3a0909b400baef7be

Grafana 接続

Elasticsearchデータの可視化