

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon OpenSearch Service データソースへの接続
<a name="using-Amazon-OpenSearch-in-AMG"></a>

**注記**  
バージョン 9 以降をサポートするワークスペースでは、このデータソースに適切なプラグインのインストールが必要になる場合があります。詳細については、「[プラグインを使用したワークスペースの拡張](grafana-plugins.md)」を参照してください。

Amazon Managed Grafana では、Grafana ワークスペースコンソールのデータソース設定オプションを使用して、Amazon OpenSearch Service を AWS データソースとして追加できます。このデータソースは、OpenSearch クラスターと従来の Elasticsearch クラスターを実行する、OpenSearch Service ドメインをサポートしています。

 AWS データソース設定オプションは、既存の OpenSearch Service アカウントを検出することで、OpenSearch Service をデータソースとして簡単に追加し、OpenSearch へのアクセスに必要な認証情報の設定を管理します。この方法を使用して認証を設定し、データソースとして OpenSearch Service を追加するか、セルフマネージド Grafana サーバーと同じ方法を使用して、データソースと必要な認証情報を手動で設定できます。

OpenSearch Service データソースはパイプ処理言語 (PPL) をサポートしています。PPL の詳細については、「[パイプ処理言語を使用した Amazon OpenSearch Service データのクエリ](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/ppl-support.html)」を参照してください。

OpenSearch Service データソースを使用すると、OpenSearch に保存されているログやメトリクスを視覚化するために、単純または複雑なさまざまな種類の OpenSearch クエリを実行できます。OpenSearch に保存されているログイベントを使用してグラフに注釈を付けることもできます。

**Topics**
+ [AWS データソース設定を使用して OpenSearch Service をデータソースとして追加する](ES-adding-AWS-config.md)
+ [Amazon OpenSearch Service をデータソースとして手動で追加する](ES-adding-the-data-source.md)
+ [OpenSearch Service の設定](#ES-settings)
+ [Amazon OpenSearch Service データソースを使用する](ES-use-datasource.md)
+ [Amazon OpenSearch Service Serverless](datasources-opensearch-serverless.md)
+ [トレースの補助機能](datasources-opensearch-traces.md)

## OpenSearch Service の設定
<a name="ES-settings"></a>


|  名前  |  説明  | 
| --- | --- | 
|  Name  |  データソース名。これは、パネルとクエリ内へのデータソースの表示のされ方です。 | 
|  Default  |  デフォルトのデータソースは、新しいパネル用に事前に選択されたデータソースです。 | 
|  Url  |  OpenSearch Service ドメインのエンドポイント。エンドポイントは https://search-my-domain.us-east-1.es.amazonaws.com. の形式になります。 | 
|  Access  |  サーバー (デフォルト) = URL は Grafana バックエンド/サーバーからアクセス可能である必要があります。ブラウザ = URL はブラウザからアクセス可能である必要があります。 | 

 アクセスモードは、データソースへのリクエストの処理方法を制御します。他に何も記述されていない場合は、サーバーが優先されます。

### サーバーアクセスモード (デフォルト)
<a name="ES-server-access-mode-default"></a>

 すべてのリクエストはブラウザから Grafana バックエンドまたはサーバーに行われ、リクエストはデータソースに転送されるため、クロスオリジンリソース共有 (CORS) 要件を回避できます。このアクセスモードを選択する場合、URL は Grafana バックエンドまたはサーバーからアクセス可能である必要があります。

### ブラウザ (直接) アクセス
<a name="ES-browser-direct-access"></a>

Amazon Managed Grafana はブラウザ直接アクセスをサポートしていません。

### インデックス設定
<a name="ES-index-settings"></a>

 ここでは、`time field` のデフォルトを指定し、OpenSearch インデックスの名前を指定できます。インデックス名またはワイルドカード文字に時間パターンを使用できます。

### OpenSearch/Elasticsear バージョン
<a name="OpenSearch-version"></a>

バージョンドロップダウンメニューで OpenSearch またはレガシー Elasticsearch バージョンを指定します。バージョンごとにクエリの構成方法が異なるため、バージョンは重要です。現在、Grafana は OpenSearch 1.0.x をサポートしています。サポートされている Elasticsearch のバージョンは、`2.0+`、`5.0+`、`5.6+`、`6.0+`、`7.0+` です。値 `5.6+` はバージョン 5.6 以降、6.0 未満を意味します。値 `6.0+` はバージョン 6.0 以降、7.0 未満を意味します。最後に、`7.0+` はバージョン 7.0 以降、8.0 未満を意味します。

### 最小時間間隔
<a name="ES-min-time-interval"></a>

時間間隔による自動グループの下限。データを 1 分ごとに書き込む場合は `1m` など、書き込み頻度に設定することをお勧めします。このオプションは、[Data Source] (データソース) オプションのダッシュボードパネルで上書き/設定することもできます。この値は、`1m` (1 分) や `30s` (30 秒) など、有効な時間識別子が続く数値としてフォーマットする**必要があります**。以下の時間識別子がサポートされています。


|  識別子  |  説明  | 
| --- | --- | 
|  y  |  年  | 
|  M  |  月  | 
|  w  |  週  | 
|  d  |  日  | 
|  h  |  時間  | 
|  m  |  分  | 
|  s  |  秒  | 
|  ms  |  ミリ秒  | 

### ログ
<a name="ES-logs-beta"></a>

2 つのパラメータである `Message field name` と `Level field name` は、オプションで、[Explore](explore.md) のログを視覚化するときにログメッセージとログレベルに使用されるフィールドを決定するデータソース設定ページから設定できます。

 例えば、OpenSearch Service へのログ配送に Filebeat のデフォルト設定を使用する場合、次の設定が機能します。
+  **メッセージフィールド名:** メッセージ 
+  **レベルフィールド名:** fields.level 

### データリンク
<a name="ES-data-links"></a>

 データリンクは、Explore のログビューでアクセスできる指定されたフィールドからリンクを作成します。

 各データリンク設定は、以下で構成されます。
+ **フィールド** – データリンクで使用されるフィールドの名前。
+ **URL/クエリ** – リンクが外部である場合は、完全なリンク URL を入力します。リンクが内部リンクの場合、この入力はターゲットデータソースのクエリとして機能します。どちらの場合も、`${__value.raw }` マクロを使用してフィールドから値を補間できます。
+ **内部リンク** – リンクが内部または外部である場合に選択します。リンクが内部の場合、データソースセレクタを使用すると、ターゲットデータソースを選択できます。データソースのトレースのみがサポートされています。