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

# OpenSearch データソースに接続する
<a name="using-opensearch-in-AMG"></a>

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

Amazon Managed Grafana では、オープンソースの [OpenSearch](https://opensearch.org/docs/) (またはレガシー Elasticsearch) をデータソースとして追加できます。OpenSearch に保存されているログまたはメトリクスを視覚化するために、単純または複雑なさまざまな種類の OpenSearch クエリを実行できます。OpenSearch に保存されているログイベントを使用してグラフに注釈を付けることもできます。

## OpenSearch をデータソースとして追加する
<a name="opensearch-adding-the-data-source"></a>

**注記**  
OpenSearch データソースを追加するには、Grafana IAM アカウントを ALL\$1ACCESS ロールと SECURITY\$1MANAGER ロールに追加する必要があります。

1.  上部ヘッダーの Grafana アイコンを選択して、サイドメニューを開きます。

1.  **[ダッシュボード]** リンクのサイドメニューには、名前付き **[データソース]** リンクがあります。

1.  上部ヘッダーの **[\$1 データソースの追加]** ボタンを選択します。

1.  **[タイプ]** ドロップダウンリストから **[OpenSearch]** を選択します。

**注記**  
 サイドメニューに **[データソース]** リンクが表示されない場合は、現在のユーザーに `Admin` ロールが付与されていないことを示します。


|  名前  |  説明  | 
| --- | --- | 
|  Name  |  データソース名。これは、パネルとクエリ内へのデータソースの表示のされ方です。 | 
|  Default  |  デフォルトのデータソースは、新しいパネル用に事前に選択されたデータソースです。 | 
|  Url  |  OpenSearch サーバーの HTTP プロトコル、IP、ポート。 | 
|  Access  |  サーバー (デフォルト) = URL は Grafana バックエンド/サーバーからアクセス可能である必要があります。ブラウザ = URL はブラウザからアクセス可能である必要があります。 | 

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

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

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

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

 Amazon Managed Grafana は、OpenSearch データソースのブラウザへの直接アクセスをサポートしていません。

### インデックス設定
<a name="opensearch-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="opensearch-min-time-interval"></a>

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


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

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

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

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

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

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

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

## OpenSearch データソースの使用
<a name="opensearch-use-datasource"></a>

### メトリクスクエリエディタ
<a name="opensearch-metric-query-editor"></a>

 OpenSearch クエリエディタを使用すると、複数のメトリクスを選択し、複数の用語またはフィルターでグループ化できます。右側のプラスアイコンとマイナスアイコンを使用して、メトリクスまたはグループを句で追加/削除します。一部のメトリクスと group by 句にはオプションがあります。オプションテキストを選択して行を展開し、オプション別にメトリクスまたはグループを表示および編集します。

### シリーズの名前付けとエイリアスパターン
<a name="opensearch-series-naming-and-alias-patterns"></a>

 `Alias` 入力フィールドを使用して時系列の名前を制御できます。


|  パターン  |  説明  | 
| --- | --- | 
|  \$1\$1term fieldname\$1\$1  |  Group By という用語の値に置き換え。 | 
|  \$1\$1metric\$1\$1  |  メトリクス名に置き換え (例：平均、最小、最大）。 | 
|  \$1\$1field\$1\$1  |  メトリクスフィールド名に置き換え。 | 

### パイプラインメトリクス
<a name="opensearch-pipeline-metrics"></a>

例えば、*移動平均*や*派生*など、一部のメトリクス集約はパイプライン集約と呼ばれます。OpenSearch パイプラインメトリクスは、別のメトリクスに基づく必要があります。メトリクスの横にある目のアイコンを使用して、メトリクスがグラフに表示されないようにします。これは、パイプラインメトリクスで使用するクエリにのみあるメトリクスに役立ちます。

### テンプレート作成
<a name="opensearch-templating"></a>

メトリクスクエリでサーバー、アプリケーション、センサー名などのものをハードコーディングする代わりに変数を使用できます。変数は、ダッシュボードの上部にドロップダウン選択ボックスとして表示されます。これらのドロップダウンボックスを使用して、ダッシュボードに表示されるデータを変更できます。

 テンプレート作成とテンプレート変数の詳細については、「[テンプレートおよび変数](templates-and-variables.md)」を参照してください。

#### クエリ変数
<a name="opensearch-query-variable"></a>

 OpenSearch データソースは、*[クエリ]*変数の*[クエリ]*フィールドで使用できる 2 種類のクエリをサポートしています。クエリは、カスタム JSON 文字列を使用して記述します。


|  クエリ  |  説明  | 
| --- | --- | 
|  \$1"find": "fields", "type": "keyword"\$1  |  インデックスタイプ keyword のフィールド名のリストを返します。 | 
|  \$1"find": "terms", "field": "@hostname", "size": 1000\$1  |  用語集約を使用してフィールドの値のリストを返します。クエリは、クエリの時間範囲として現在のダッシュボードの時間範囲を使用します。 | 
|  \$1"find": "terms", "field": "@hostname", "query": '<lucene query>'\$1  |  用語集約と指定された Lucene クエリフィルターを使用して、フィールドの値のリストを返します。クエリは、クエリの時間範囲として現在のダッシュボードの時間範囲を使用します。 | 

用語クエリにはデフォルトのサイズ制限 500 があります。カスタム制限を設定するには、クエリのサイズプロパティを設定します。クエリでは、その他の変数を使用できます。次のコード例は、`$host` という名前の変数のクエリ定義を示しています。

```
{"find": "terms", "field": "@hostname", "query": "@source:$source"}
```

前の例では、クエリ定義内で `$source` という名前の別の変数を使用します。`$source` 変数の現在の値をドロップダウンリストで変更すると、`$host` 変数の更新が開始されます。更新後、`$host` 変数にはホスト名のみが含まれます。この場合、`@source` ドキュメントプロパティによってフィルタリングされます。

デフォルトでは、これらのクエリは用語の順序で返されます (その後、任意の変数と同様にアルファベット順または数値順にソートできます）。ドキュメント数でソートされた用語のリスト (上位 N の値リスト) を作成するには、`doc_count` の `orderBy` プロパティを追加します。これにより、降順ソートが自動的に選択されます。doc\$1count (降順 N リスト) で `asc` を使用するには、`order: "asc"` を設定しますが、ドキュメントカウントのエラーが増加するため、推奨されません。ドキュメントカウントの順序で用語を保持するには、変数の **[ソート]** ドロップダウンリストを**[無効]**に設定します。または、**[アルファベット]**順を使用して再ソートすることもできます。

```
{"find": "terms", "field": "@hostname", "orderBy": "doc_count"}
```

#### クエリでの変数の使用
<a name="opensearch-using-variables-in-queries"></a>

 2 つの構文があります。
+  `$<varname>` 例: @hostname:\$1hostname 
+  `[[varname]]` 例: @hostname:[[hostname]] 

 なぜ 2 つの方法があるのですか？ 最初の構文は読み書きが容易ですが、単語の途中で変数を使用することは許可されません。*[複数値]*または*[すべての値を含める]*オプションが有効になっている場合、Grafana はラベルをプレーンテキストから Lucene 互換の条件に変換します。

 前の例では、`$hostname` という名前の変数を使用して `@hostname` プロパティに基づいてドキュメントをフィルタリングする Lucene クエリがあります。また、フィールド入力ボックス別の*用語*グループで変数を使用しています。これにより、変数を使用してデータのグループ化方法をすばやく変更できます。

### ‏注釈
<a name="opensearch-annotations"></a>

注釈を使用すると、グラフの上にリッチイベント情報をオーバーレイできます。ダッシュボードメニューまたは注釈ビューを使用して注釈クエリを追加します。Grafana は、注釈イベントの OpenSearch インデックスをクエリできます。詳細については、「[‏注釈](dashboard-annotations.md)」を参照してください。


|  名前  |  説明  | 
| --- | --- | 
|  Query  |  検索クエリは空白のままにするか、Lucene クエリを指定できます。 | 
|  Time  |  時間フィールドの名前。 日付フィールドである必要があります。 | 
|  Time End  |  終了時刻フィールドのオプション名は日付フィールドである必要があります。設定されている場合、注釈は時間と終了時間の間のリージョンとしてマークされます。 | 
|  Text  |  イベントの説明フィールド。 | 
|  Tags  |  イベントタグに使用するオプションのフィールド名 (配列または CSV 文字列）。 | 

### ログのクエリ
<a name="opensearch-querying-logs-beta"></a>

 OpenSearch からのログデータのクエリと表示は、Explore で確認できます。ログを表示するには、OpenSearch データソースを選択し、オプションで Lucene クエリを入力します。詳細については、「[Explore](explore.md)」を参照してください。

#### ログクエリ
<a name="opensearch-log-queries"></a>

 結果が返されると、ログパネルにログ行のリストと棒グラフが表示されます。x 軸は時間、y 軸は頻度またはカウントを示します。

#### ログメッセージのフィルタリング
<a name="opensearch-filter-log-messages"></a>

 必要に応じて、クエリフィールドに Lucene クエリを入力して、ログメッセージをフィルタリングできます。例えば、デフォルトの Filebeat 設定を使用すると、`fields.level:error` を使用してエラーメッセージのみを表示できます。