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

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

 Loki データソースは、Grafana のログ集約システムである Loki へのアクセスを提供します。

## データソースの追加
<a name="loki-adding-the-data-source"></a>

1.  Grafana ワークスペースを開き、ログインしていることを確認します。

1.  **[設定]** リンクのサイドメニューに **[データソース]** リンクがあります。

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

1.  データソースのリストから **Loki** を選択します。

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


|  名前  |  説明  | 
| --- | --- | 
|  Name  |  データソース名。これはパネル、クエリ、Explore でデータソースを表示する方法です。 | 
|  Default  |  デフォルトのデータソースは、新しいパネル用に事前に選択されたデータソースです。 | 
|  URL  | Loki インスタンスの URL。例: http://localhost:3100。これは、Amazon EC2 ホストの URL、Amazon EKS クラスターの前の Application Load Balancer、または Loki インスタンスのその他の URL です。 | 
|  Maximum lines  |  Loki によって返されるログの行数の上限 (デフォルトは 1000 行)。Explore でログを表示するときにブラウザが遅い場合は減らします。 | 

### 派生フィールド
<a name="loki-derived-fields"></a>

 *派生フィールド*の設定を使用して、次のことを行うことができます。
+  ログメッセージから解析されたフィールドを追加します。
+  フィールドの値を使用するリンクを追加します。

 この機能を使用して、ログから直接トレースバックエンドにリンクしたり、ログラインに userId がある場合はユーザープロファイルページにリンクしたりできます。これらのリンクはログの詳細に表示されます。詳細については、「[ラベルと検出されたフィールド](explore.md#labels-and-detected-fields)」を参照してください。

各派生フィールドは以下で構成されます。
+  **名前** – ログの詳細にラベルとして表示されます。
+  **正規表現** – ログメッセージで実行され、その一部を新しいフィールドの値としてキャプチャする正規表現パターン。1 つのキャプチャグループのみを含めることができます。
+  **URL/クエリ** – リンクが外部である場合は、完全なリンク URL を入力します。リンクが内部リンクの場合、この入力はターゲットデータソースのクエリとして機能します。どちらの場合も、`${__value.raw }` マクロを使用してフィールドから値を補間できます。
+  **内部リンク** – リンクが内部か外部かを選択します。内部リンクの場合、データソースセレクタを使用すると、ターゲットデータソースを選択できます。データソースのトレースのみがサポートされています。

 デバッグセクションを使用して、フィールドが抽出する内容と URL がどのように補間されるかを確認できます。**[ログメッセージの例を表示]** を選択して、ログメッセージを入力できるテキスト領域を表示します。

 ログの詳細に表示されるリンクを含む新しいフィールド。

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

 Loki からのログデータのクエリと表示は、Explorer 経由か、視覚化のログパネルで利用できます。Loki データソースを選択し、LogQL クエリを入力してログを表示します。LogQL の詳細については、「[LogQL](https://grafana.com/docs/loki/latest/logql/)」を参照してください。

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

 ログクエリは、**ログストリームセレクタ**と**検索式 **の 2 つの部分で構成されます。パフォーマンス上の理由から、まずログストリームのログラベルを選択する必要があります。

 クエリフィールドの横にある Logs Explorer (**[ログラベル]** ボタン) には、使用可能なログストリームのラベルのリストが表示されます。クエリを記述する別の方法は、クエリフィールドの自動入力を使用することです。まず、左の中括弧 `{` を入力すると、オートコンプリートメニューにラベルのリストが表示されます。**Enter** キーを押してクエリを実行します。

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

### ログストリームセレクタ
<a name="log-stream-selector"></a>

 クエリ式のラベル部分については、それを中括弧 `{}` で囲み、キー値の構文を使用してラベルを選択します。複数のラベル式はカンマで区切ります。

 `{app="mysql",name="mysql-backup"}` 

 以下のラベルマッチングオペレーションは現在サポートされています。
+  `=` 完全に等しい。
+  `!=` 等しくない。
+  `=~` 正規表現一致。
+  `!~` 正規表現に一致しない。

 例: 
+  `{name=~"mysql.+"}` 
+  `{name!~"mysql.+"}` 

 ラベルセレクタを追加するもう 1 つの方法は、テーブルセクションにあります。ラベルの横にある**フィルター**を選択して、クエリ式にラベルを追加します。これは複数のクエリでも機能します。複数のクエリの場合、各クエリにラベルセレクタを追加します。

### Search 式
<a name="loki-search-expression"></a>

 ログストリームセレクタを記述した後、検索式を記述することで、結果をさらにフィルタリングできます。検索式は、単なるテキスト式または正規表現にすることができます。

 クエリの例: 
+  `{job="mysql"} |= "error"` 
+  `{name="kafka"} |~ "tsdb-ops.*io:2003"` 
+  `{instance=~"kafka-[23]",name="kafka"} != "kafka.server:type=ReplicaManager"` 

 フィルター演算子は連鎖でき、式を順次フィルタリングします。結果のログラインは、すべてのフィルターに適用されます。

 例 

 `{job="mysql"} |= "error" != "timeout"` 

 現在、次のフィルタータイプがサポートされています。
+  `|=` 行には文字列が含まれている。
+  `!=` 行に文字列が含まれていない。
+  `|~` 行が正規表現と一致する。
+  `!~` 行が正規表現パターンに一致しない。

**注記**  
 Loki のクエリ言語である LogQL の詳細については、「[Loki LogQL](https://grafana.com/docs/loki/latest/logql/)」を参照してください。

## ログのコンテキスト
<a name="loki-log-context"></a>

 上記の検索式を使用すると、フィルタリングされた結果を囲むコンテキストを取得できるようになりました。フィルタリングされた行の `Show Context` リンクを選択すると、関心のあるログメッセージの前後に発生したログメッセージを調査できます。

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

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

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

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

 非メトリクス Loki クエリは、注釈のソースとして使用できます。ログコンテンツは注釈テキストとして使用され、ログストリームラベルはタグとして使用されるため、追加のマッピングは必要ありません。