翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # ダッシュボードの構築 **** このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。 Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。 Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。 Grafana ワークスペースを作成してサインインすると、ダッシュボードを作成し、ニーズに合わせて設定を変更できます。 **Topics** + [ダッシュボードの作成](v9-dash-creating.md) + [パネルの追加または編集](v9-dash-edit-panels.md) + [ダッシュボード設定の変更](v9-dash-modify-settings.md) + [ダッシュボード URL 変数](v9-dash-dashboard-url-variables.md) + [ダッシュボードへのライブラリパネルの追加](v9-dash-manage-library-panels.md) + [ダッシュボードのバージョン履歴の管理](v9-dash-manage-version-history.md) + [ダッシュボードリンクの管理](v9-dash-manage-dashboard-links.md) + [ダッシュボード JSON モデル](v9-dash-dashboard-json-model.md) # ダッシュボードの作成 **** このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。 Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。 Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。 **ダッシュボードの作成** ダッシュボードとパネルを使用すると、Grafana を使用してデータを視覚的に表示できます。各パネルには、視覚化を表示するために少なくとも 1 つのクエリが必要です。開始する前に、前提条件として次の作業を完了します。 + 適切なアクセス許可を持っていることを確認してください。権限の詳細については、「[ユーザー、チーム、およびアクセス許可](Grafana-administration-authorization.md)」を参照してください。 + パネルを追加するダッシュボードを特定します。 + ターゲットデータソースのクエリ言語を理解します。 + クエリを記述するデータソースが追加されていることを確認します。 ダッシュボードを作成するには: 1. Grafana にサインインし、**[ダッシュボード]**にカーソルを合わせ、 **[\$1 新しいダッシュボード]** をクリックします。 1. **[新しいパネルの追加]** をクリックします。 1. **[クエリ]** タブの最初の行で、ドロップダウンリストをクリックしてデータソースを選択します。 1. データソースのクエリ言語でクエリを記述または作成します。 1. **[視覚化]** リストで、視覚化タイプを選択します。Grafana は、視覚化が適用されたクエリ結果のプレビューを表示します。詳細については、「[視覚化のオプション](v9-panels-viz.md)」を参照してください。 1. 次の方法でパネル設定を調整します。 + [値マッピングを設定する](v9-panels-configure-value-mappings.md) + [視覚化固有のオプション](v9-panels-viz.md) + [フィールド値を上書きする](v9-panels-configure-overrides.md) + [しきい値を設定する](v9-panels-configure-thresholds.md) + [標準オプションを設定する](v9-panels-configure-standard-options.md) **注記** ほとんどの視覚化では、情報を適切に表示する前にある程度の調整が必要です。 1. 視覚化を記述する (または変更を記述する) メモを追加し、ページの右上にある **[保存]** をクリックします。 **注記** ダッシュボードを以前のバージョンに戻す必要が生じた際、このメモが役に立ちます。 **繰り返し行の設定** 変数の値に基づいてダッシュボードにパネルまたは行を動的に追加するように Grafana を設定できます。変数は、ダッシュボード内のすべての行にわたってクエリを動的に変更します。パネルの繰り返しの詳細については、「[繰り返しパネルの設定]()」を参照してください。 `Multi-value` [または]`Include all values` が選択された変数セットがある場合は、行を繰り返すこともできます。 開始する前に、クエリに複数値変数が含まれていることを確認し、次のステップを実行します。 1. ダッシュボードのホームページで、**[パネルの追加]** をクリックします。 1. **[パネルの追加]** ダイアログボックスで、**[新しい行の追加]** をクリックします。 1. 行タイトルにカーソルを合わせ、歯車アイコンをクリックします。 1. **[行オプション]** ダイアログボックスで、タイトルを追加し、繰り返し行を追加する変数を選択します。 **注記** ダッシュボードユーザーにコンテキストを提供するには、行タイトルに変数を追加します。 **パネルを移動するには** 1. ダッシュボードを開きます。 1. パネルタイトルをクリックし、パネルを新しい場所にドラッグします。パネルは、任意の場所のダッシュボードに配置することができます。 **パネルのサイズを変更するには** 1. ダッシュボードを開きます。 1. パネルのサイズを調整するには、パネルの右下隅をクリックしてドラッグします。ダッシュボードパネルは、ニーズに合わせてサイズ調整できます。 # パネルの追加または編集 **** このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。 Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。 Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。 ダッシュボードを作成したら、パネルをいつでも追加、編集、または削除できます。 + **ダッシュボードの表示**: ダッシュボードを表示するには、**[ホーム]**メニューから **[ダッシュボード]** を選択し、表示するダッシュボードを選択します。ダッシュボードを含むフォルダを展開する必要がある場合があります。 + **パネルの追加**: ダッシュボードにパネルを追加するには、ページの上部にあるメニューバーで **[パネルの追加]** アイコンを選択します。 + **パネルの編集**: ダッシュボード上の既存のパネルを編集するには、パネルにカーソルを合わせたときに表示されるメニューアイコンを選択し、**[編集]** を選択します。 + **パネルの削除**: ダッシュボード上の既存のパネルを削除するには、パネルにカーソルを合わせたときに表示されるメニューアイコンを選択し、**[削除]** を選択します。 # ダッシュボード設定の変更 **** このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。 Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。 Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。 ダッシュボード設定ページでは、次の操作を実行できます。 + 時間設定を含む一般的なダッシュボードプロパティを編集する。 + 注釈クエリを追加する。 + ダッシュボード変数を追加する。 + リンクを追加する。 + ダッシュボードの JSON モデルを表示する ダッシュボード設定ページにアクセスするには 1. ダッシュボードを編集モードで開きます。 1. ページの上部にある **[ダッシュボード設定]** (歯車アイコン) をクリックします。 **ダッシュボードの時間設定の変更** ダッシュボードのタイムゾーン、ローカルブラウザの時刻を変更するときにダッシュボードの時刻設定を調整し、自動更新の時間間隔を指定します。 **ダッシュボードの時間設定を変更するには** 1. **[ダッシュボード]** 設定ページで、**[全般]** を選択します。 1. **[時間オプション]** セクションに移動します。 1. 以下の説明に従って時間設定を指定します。 1. タイムゾーンは、モニタリングするサービスまたはシステムのローカルタイムゾーンを指定します。これは、複数のタイムゾーンで動作するシステムまたはサービスを監視する場合に役立ちます。 + Grafana は、ユーザープロファイル、チーム、または組織に*デフォルト*で選択されたタイムゾーンを使用します。ユーザープロファイル、ユーザーが所属するチーム、または組織にタイムゾーンが指定されていない場合、Grafana はローカルブラウザの時間を使用します。 + ユーザーブラウザの表示用に設定されたタイムゾーン、*ローカルブラウザ時間*が使用されます。これは通常、コンピュータに設定されているタイムゾーンと同じです。 + UTC を含む標準の [ISO 8601 タイムゾーン ](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)を使用します。 + **[自動更新]** は、相対時間に表示されるオプションをカスタマイズし、自動更新オプションエントリはカンマ区切りで、有効な時間単位を受け入れます。 + **[遅延時間の指定]** は、遅延時間を入力して `now` 時間を上書きします。このオプションを使用して、null 値を避けるために、データ集約の既知の遅延に対応します。 + **[タイムピッカーを非表示]** は、Grafana タイムピッカーの表示を非表示にします。 **注記** 時間コントロールの使用には、データに時間列が含まれている必要があります。時間列を含める方法の詳細については、特定の「[データソース](AMG-data-sources.md)」のドキュメントを参照してください。 **[注釈クエリの追加]** 注釈クエリは、イベントをクエリするクエリです。これらのイベントは、カーソルを合わせるとイベント情報を表示できる小さなアイコンとともに、ダッシュボード全体のグラフで垂直線として視覚化できます。 **n 注釈クエリを追加するには** 1. **[ダッシュボード設定]** ページで、**[注釈]** を選択します。 1. **[注釈クエリの追加]** を選択します。 1. 名前を入力し、データソースを選択します。 1. フォームの残りの部分に入力して、クエリと注釈を作成します。 クエリエディタの UI は、選択したデータソースに基づいて変わります。クエリの作成方法の詳細については、「[データソース](AMG-data-sources.md)」ドキュメントを参照してください。 **変数の追加** 変数を使用すると、よりインタラクティブで動的なダッシュボードを作成できます。メトリクスクエリでサーバー、アプリケーション、センサー名などをハードコーディングする代わりに変数を使用できます。変数は、ダッシュボードの上部にドロップダウンリストとして表示されます。これらのドロップダウンを使用すると、ダッシュボード内に表示されるデータを簡単に変更できます。 変数の詳細については、「[変数](v9-dash-variables.md)」を参照してください。 1. **[ダッシュボード設定]** ページで、左側のセクションメニューの **[変数]**、**[変数を追加]** ボタンを続けてクリックします。 1. **[全般]** セクションで、変数の名前を追加します。これは、後でクエリで使用する名前です。 1. 変数**タイプ**を選択します。 **注記** 選択した変数タイプは、ページに入力するフィールドに影響します。 1. 変数を定義し、**[更新]** をクリックします。 **リンクの追加** ダッシュボードリンクを使用すると、他のダッシュボードやウェブサイトへのリンクをダッシュボードヘッダーの直下に配置できます。リンクを使用すると、他の関連するダッシュボードやコンテンツに簡単に移動できます。 1. **[ダッシュボード設定]** ページで、左側のセクションメニューから **[リンク]** をクリックし、次に **[リンクを追加]** ボタンをクリックします。 1. タイトルを入力し、**[タイプ]** フィールドに **[ダッシュボード]** または **[リンク]** を選択します。 1. ダッシュボードリンクを追加するには、オプションのタグを追加し、ダッシュボードリンクのオプションを選択して、**[適用]** をクリックします。 **注記** タグは、すべてが特定のタグを持つダッシュボードの動的なドロップダウンを作成するのに役立ちます。 1. リンクを追加するには、ユーザーがリンクの上にカーソルを置いたときに表示される URL とツールヒントテキストを追加し、リンクの横に表示されるアイコンを選択して、ダッシュボードのリンクオプションを選択します。 **ダッシュボードの JSON モデルを表示する ** Grafana のダッシュボードは、ダッシュボードのメタデータを保存する JSON オブジェクトによって表されます。ダッシュボードメタデータには、ダッシュボードプロパティ、パネルからのメタデータ、テンプレート変数、パネルクエリなどが含まれます。 ダッシュボード JSON モデルを表示するには、**[ダッシュボード設定]** ページで **[JSON]** をクリックします。 JSON フィールドの詳細については、「[JSON フィールド](v9-dash-dashboard-json-model.md)」を参照してください。 # ダッシュボード URL 変数 **** このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。 Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。 Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。 Grafana は、ダッシュボード URL でクエリパラメータとして渡された変数値を適用できます。詳細については、「[ダッシュボードリンクの管理](v9-dash-manage-dashboard-links.md)」と「[テンプレートおよび変数の管理](v9-dash-variables.md)」を参照してください。 **変数をクエリパラメータとして渡す** Grafana は、`var-` のプレフィックスが付加されたクエリ文字列パラメータを、特定のダッシュボードの変数として解釈します。 例えば、この URL では、次のようになります。 ``` https://${your-domain}/path/to/your/dashboard?var-example=value ``` クエリパラメータ `var-example=value` は、ダッシュボード変数の例を表し、値は `value` です。 **変数に複数の値を渡す** 複数の値を渡すには、値ごとに変数パラメータを 1 回繰り返します。 ``` https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2 ``` Grafana は、 `var-example=value1&var-example=value2` を `value1` と `value2` の 2 つの値を持つダッシュボード変数の例として解釈します。 **ダッシュボードリンクへの変数の追加** Grafana は、ダッシュボードの設定から変数を生成するときに、ダッシュボードリンクに変数を追加できます。変数を追加する方法と手順の詳細については、「[ダッシュボードリンクの管理](v9-dash-manage-dashboard-links.md)」を参照してください。 **アドホックフィルターを渡す** アドホックフィルターは、指定されたデータソースを使用するすべてのメトリクスクエリにキーまたは値フィルターを適用します。詳細については、「[アドホックフィルター]()」を参照してください。 アドホックフィルターをクエリパラメータとして渡すには、変数構文を使用してアドホックフィルター変数を渡し、キー、演算子を値、値をパイプ区切りリストとして指定します。 例えば、この URL では、次のようになります。 `https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value` クエリパラメータ `var-adhoc=key|=|value` は、 `example_key` キー、 `=` 演算子、および `example_value` 値を使用して、アドホックダッシュボード変数として設定されたアドホックフィルターを適用します。 **注記** アドホックフィルターを使用して URL を共有する場合は、必ず URL をエンコードしてください。上記の例では、パイプ `(|)` を `%7C`に、等価演算子 `(=)` を ` %3D` に置き換えます。 **URL の使用による時間範囲の制御** ダッシュボードの時間範囲を設定するには、`from`、`to`、`time`、および `time.window` クエリパラメータを使用します。これらは変数ではないため、`var-` プレフィックスは必要ありません。 # ダッシュボードへのライブラリパネルの追加 **** このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。 Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。 Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。 ライブラリパネルは、任意のダッシュボードで使用できる再利用可能なパネルです。ライブラリパネルを変更すると、その変更はパネルが使用されているすべてのインスタンスに反映されます。ライブラリパネルは、複数のダッシュボード間でパネルの再利用を合理化します。 ライブラリパネルは、保存されたダッシュボードとともにフォルダに保存できます。 **ライブラリパネルの作成** ライブラリパネルを作成すると、ソースダッシュボードのパネルもライブラリパネルに変換されます。パネルが変換されたら、元のダッシュボードを保存する必要があります。 1. 編集モードでパネルを開きます。 1. パネル表示オプションで、下矢印オプションをクリックして、視覚化に変更を加えます。 1. **[作成]** ダイアログボックスを開くには、**[ライブラリパネル]** オプションをクリックし、**[ライブラリパネルの作成]** をクリックします。 1. **[ライブラリパネル名]** に名前を入力します。 1. **[フォルダに保存]** で、ライブラリパネルを保存するフォルダを選択します。 1. **[ライブラリパネルの作成]** をクリックして変更を保存します。 1. ダッシュボードを保存するには、 **[保存]** をクリックします。 ライブラリパネルの作成後、そのパネルは、パネルが表示される任意のダッシュボードを使用して変更することができます。変更を保存すると、ライブラリパネルのすべてのインスタンスにこれらの変更が反映されます。 **ダッシュボードへのライブラリパネルの追加** 他のダッシュボードユーザーに視覚化を提供する場合は、Grafana ライブラリパネルをダッシュボードに追加します。 1. 左のメニューの **[ダッシュボード]** オプションにカーソルを合わせ、ドロップダウンオプションから **[新しいダッシュボード]** を選択します。**[パネルの追加]** ダイアログボックスが開きます。 1. [パネルライブラリ] オプションから **[パネルの追加]** をクリックします。ライブラリパネルのリストが表示されます。 1. リストを検索またはフィルタリングして、追加するパネルを見つけます。 1. パネルをクリックしてダッシュボードに追加します。 **ライブラリパネルのリンク解除** ライブラリパネルに変更を加える必要があるときにライブラリパネルの他のインスタンスに影響を与えたくない場合は、ライブラリパネルのリンクを解除します。 1. 左側のメニューの **[ダッシュボード]** にカーソルを合わせ、**[ライブラリパネル]** をクリックします。 1. さまざまなダッシュボードで使用されているライブラリパネルを選択します。 1. リンクを解除するパネルを選択します。 1. パネルのタイトルをクリックし、**[編集]** をクリックします。パネルは編集モードで開きます。 1. ページの右上隅にある **[リンク解除]** オプションをクリックします。 **ライブラリパネルのリストの表示** ライブラリパネルに変更を加える必要があるときにライブラリパネルの他のインスタンスに影響を与えたくない場合は、ライブラリパネルのリンクを解除します。 1. 左側のメニューの **[ダッシュボード]** オプションにカーソルを合わせ、**[ライブラリパネル]** をクリックします。以前に定義したライブラリパネルのリストが表示されます。 1. 名前がわかっている場合は、特定のライブラリパネルを検索します。パネルをフォルダまたはタイプでフィルタリングすることもできます。 **ライブラリパネルの削除** 不要になったライブラリパネルを削除します。 1. 左側のメニューの **[ダッシュボード]** にカーソルを合わせ、**[ライブラリパネル]** を選択します。 1. 削除するパネルを選択します。 1. ライブラリ名の横にある [削除] アイコンをクリックします。 # ダッシュボードのバージョン履歴の管理 **** このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。 Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。 Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。 ダッシュボードのバージョンを保存するたびに、以前のバージョンのダッシュボードが失われないように、そのバージョンのコピーが保存されます。これらのバージョンのリストは、ダッシュボード設定に進み、左側のメニューで **[バージョン]** を選択することで確認できます。 ダッシュボードのバージョン履歴機能では、以前に保存したダッシュボードバージョンを比較して復元できます。 **2 つのダッシュボードバージョンの比較** 2 つのダッシュボードバージョンを比較するには、比較するリストから 2 つのバージョンを選択します。**[バージョンの比較]** をクリックして、2 つのバージョン間の差分を表示します。 ボタンをクリックすると、差分ビューが表示されます。デフォルトでは、変更の概要がテキストで表示されます。 また、下部の **[JSON 差分の表示]** ボタンをクリックすることで、ダッシュボードを表す raw JSON の差分を表示できます。 差分対象のバージョンに復元する場合は、右上の **[バージョン に復元]** ボタンをクリックして復元できます。 **以前に保存したダッシュボードバージョンへの復元** 以前に保存したダッシュボードバージョンに復元する必要がある場合は、ダッシュボードバージョンリストの行の右側にある**[復元**] ボタンを選択するか、差分ビューで **[バージョン に復元]** ボタンを選択します。ボタンをクリックすると、復元の確認を求める次のポップアップが表示されます。 以前のバージョンに復元すると、バージョン番号が異なるだけで、以前のバージョンとまったく同じデータを含む新しいバージョンが作成されます。これは、新しいダッシュボードバージョンの行の **[メモ列]** に表示されます。これは、以前のダッシュボードバージョンが変更の影響を受けないようにするためにのみ行われます。 # ダッシュボードリンクの管理 **** このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。 Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。 Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。 リンクを使用すると、よく使用されるダッシュボード間を移動、または他のユーザーを視覚化に接続できます。リンクでは、他のダッシュボード、パネル、さらには外部ウェブサイトへのショートカットを作成できます。 Grafana では、ダッシュボードリンク、パネルリンク、データリンクをサポートしています。ダッシュボードリンクはダッシュボードの上部に表示されます。パネルリンクにアクセスするためには、パネルの左上隅にあるアイコンを選択します。 **使用するリンクの選択** 最初にダッシュボード間の現在の移動方法を確認します。頻繁に一連のダッシュボード間でジャンプし、各ダッシュボードで同じコンテキストを見つけるのに苦労している場合、ワークフローの最適化にリンクが役立ちます。 次のステップでは、ご使用のワークフローに適したリンクタイプを特定します。Grafana のすべてのリンクタイプは他のダッシュボードや外部ウェブサイトへのショートカットの作成に使用されますが、それらはさまざまなコンテキストで動作します。 + リンクがダッシュボード内のほとんどのパネルに関連する場合は、ダッシュボードリンクを使用します。 + 特定のパネルにドリルダウンする場合は、パネルリンクを使用します。 + 外部サイトへのリンクには、ダッシュボードリンクまたはパネルリンクのいずれかを使用できます。 + 特定のシリーズ、または 1 つの測定までドリルダウンするには、データリンクを使用します。 **URL の使用による時間範囲の制御** ダッシュボード URL に次のクエリパラメータを指定すると、パネルまたはダッシュボードの時間範囲を制御できます。 + `from` は、エポックミリ秒で指定した、時間範囲の下限を定義します。 + `to` は、エポックミリ秒で指定された時間範囲の上限を定義します。 + `time` および `time.window` は、`time-time.window/2` から `time+time.window/2` までの時間範囲を定義します。両方のパラメータをミリ秒で指定する必要があります。たとえば、`?time=1500000000000&time.window=10000` は、1499999995000 から 1500000005000 までの 10 秒の時間範囲になります。 **ダッシュボードリンク** ダッシュボードリンクを作成するときに、時間範囲と現在のテンプレート変数を含めることで、別のダッシュボードの同じコンテキストに直接ジャンプできます。これにより、リンクの送信先が適切なデータを表示しているかどうかを心配する必要がなくなります。他のタイプのリンクについては、「[データリンク変数]()」を参照してください。 ダッシュボードリンクは、[現在のダッシュボード名で GitHub の問題](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests)を送信するなど、外部システムへのショートカットとしても使用できます。 ダッシュボードリンクを追加すると、ダッシュボードの右上隅に表示されます。 **ダッシュボードへのリンクの追加** 現在のダッシュボードの上部にある他のダッシュボードへのリンクを追加します。 1. リンクするダッシュボードを表示しながら、画面上部の歯車をクリックして **[ダッシュボード設定]** を開きます。 1. **[リンク]** をクリックし、**[ダッシュボードリンクを追加]** または **[新規]** をクリックします。 1. **[タイプ]** で、**[ダッシュボード]** を選択します。 1. 以下からリンクオプションを選択します。 + **[タグあり]**: タグを入力して、リンクされたダッシュボードを、入力したタグを持つダッシュボードのみに制限します。それ以外の場合、Grafana には他のすべてのダッシュボードへのリンクが含まれます。 + **[ドロップダウン]**: 多くのダッシュボードにリンクしている場合は、このオプションを選択し、ドロップダウンにオプションのタイトルを追加することをお勧めします。それ以外の場合、Grafana はダッシュボードのリンクをダッシュボードの上部に並べて表示します。 + **[時間範囲]**: リンクにダッシュボードの時間範囲を含めるには、このオプションを選択します。ユーザーがリンクをクリックすると、リンクされたダッシュボードが開き、指定された時間範囲が既に設定されています。 + **[変数値]**: このオプションを選択すると、リンクにクエリパラメータとして現在使用されているテンプレート変数を含めることができます。ユーザーがリンクをクリックすると、リンクされたダッシュボード内の一致するテンプレートがリンクの値に設定されます。詳細については、「[ダッシュボード URL 変数](v9-dash-dashboard-url-variables.md)」を参照してください。 + **[新しいタブで開く]**: ダッシュボードリンクを新しいタブまたはウィンドウで開く場合は、このオプションを選択します。 1. **[追加]** をクリックします。 **ダッシュボードへの URL リンクの追加** 現在のダッシュボードの上部にある URL へのリンクを追加します。ダッシュボード、パネル、外部サイトなど、使用可能なあらゆる URL にリンクできます。時間範囲を制御して、ユーザーが Grafana の適切なデータを重点的に確認できるようにすることもできます。 1. リンクするダッシュボードを表示しながら、画面上部の歯車をクリックして **[ダッシュボード設定]** を開きます。 1. **[リンク]** をクリックし、**[ダッシュボードリンクを追加]** または **[新規]** をクリックします。 1. [タイプ] で **[リンク]** を選択します。 1. 以下からリンクオプションを選択します。 + **URL**: リンク先の URL を入力します。ターゲットによっては、フィールド値を含めることもできます。詳細については、[この Github の例](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests)を参照してください。 + **タイトル**: リンクを表示するタイトルを入力します。 + **ツールヒント**: リンクを表示するツールヒントを入力します。 + **アイコン**: リンクとともに表示するアイコンを選択します。 + **[時間範囲]**: リンクにダッシュボードの時間範囲を含めるには、このオプションを選択します。ユーザーがリンクをクリックすると、リンクされたダッシュボードが開き、指定された時間範囲が設定されます。 + `from` は、エポックミリ秒で指定した、時間範囲の下限を定義します。 + `to` は、エポックミリ秒で指定された時間範囲の上限を定義します。 + `time` および `time.window` は、`time-time.window/2` から `time+time.window/2` までの時間範囲を定義します。両方のパラメータをミリ秒で指定する必要があります。たとえば、`?time=1500000000000&time.window=10000` は、1499999995000 から 1500000005000 までの 10 秒の時間範囲になります。 + **[変数値]**: このオプションを選択すると、リンクにクエリパラメータとして現在使用されているテンプレート変数を含めることができます。ユーザーがリンクをクリックすると、リンクされたダッシュボード内の一致するテンプレートがリンクの値に設定されます。 変数の形式は次のとおりです。 `https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2` + **[新しいタブで開く]**: ダッシュボードリンクを新しいタブまたはウィンドウで開く場合は、このオプションを選択します。 1. **[追加]** をクリックします。 **ダッシュボードリンクの更新** 既存のダッシュボードリンクを変更または更新するには、次のステップに従います。 1. **[ダッシュボード設定]**, の **[リンク]** タブで、編集する既存のリンクをクリックします。 1. 設定を変更し、**[更新]** をクリックします。 **ダッシュボードリンクの複製** 既存のダッシュボードリンクを複製するには、複製する既存のリンクの横にある複製アイコンをクリックします。 **ダッシュボードリンクの削除** 既存のダッシュボードリンクを削除するには、削除する複製アイコンの横にあるゴミ箱アイコンをクリックします。 **パネルリンク** 各パネルには、パネルの左上隅に表示する一連の独自のリンクを含めることができます。ダッシュボード、パネル、外部サイトなど、使用可能なあらゆる URL にリンクできます。時間範囲を制御して、ユーザーが Grafana の適切なデータを重点的に確認できるようにすることもできます。 使用可能なパネルリンクを表示するには、パネルの左上隅にあるアイコンをクリックします。 + **パネルリンクの追加**: 各パネルには、パネルの左上隅に表示される独自のリンクセットを指定できます。ダッシュボード、パネル、外部サイトなど、使用可能なあらゆる URL にリンクできます。時間範囲を制御して、ユーザーが Grafana の適切なデータを重点的に確認できるようにすることもできます。パネルの左上隅にあるアイコンをクリックすると、使用可能なパネルリンクが表示されます。 1. リンクを追加するパネルにカーソルを合わせ、`e` を押すか、または、パネルタイトルの横にあるドロップダウン矢印をクリックし、**[編集]** をクリックします。 1. **[パネル]** タブで、**[リンク]** セクションまでスクロールダウンします。 1. **[リンク]**を展開し、**[リンクの追加]** をクリックします。 1. **[タイトル]** を入力します。**[タイトル]**は、UI に表示されるリンクの判読可能なラベルです。 1. リンク先の **URL** を入力します。ダッシュボードで定義済みのテンプレート変数のいずれかを追加することもできます。`Ctrl+Space` または `Cmd+Space` を押して URL フィールドをクリックし、使用可能な変数を表示します。パネルリンクにテンプレート変数を追加することで、関連する変数がすでに設定されている適切なコンテキストをリンクからユーザーに送信します。 時間変数も使用できます。 + `from` は、エポックミリ秒で指定した、時間範囲の下限を定義します。 + `to` は、エポックミリ秒で指定した、時間範囲の上限を定義します。 + `time` および `time.window` は、`time-time.window/2` から `time+time.window/2` までの時間範囲を定義します。両方のパラメータはミリ秒で指定する必要があります。たとえば、`?time=1500000000000&time.window=10000` は、1499999995000 から 1500000005000 までの 10 秒の時間範囲になります。 + **パネルリンクの更新** 1. **[パネル]** タブで、変更するリンクを見つけます。 1. **[編集]** (鉛筆) アイコンをクリックして、[リンクの編集] ウィンドウを開きます。 1. 必要に応じて変更します。 1. **[保存]** をクリックして変更を保存し、ウィンドウを閉じます。 1. 右上の **[保存]** をクリックして、ダッシュボードに変更を保存します。 + **パネルリンクの削除** 1. **[パネル]** タブで、変更するリンクを見つけます。 1. 削除するリンクの横にある **[X]** アイコンをクリックします。 1. 右上の **[保存]** をクリックして、ダッシュボードに変更を保存します。 # ダッシュボード JSON モデル **** このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。 Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。 Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。 Grafana のダッシュボードは、ダッシュボードのメタデータを保存する JSON オブジェクトによって表されます。ダッシュボードメタデータには、ダッシュボードプロパティ、パネルからのメタデータ、テンプレート変数、パネルクエリが含まれます。 ダッシュボードの JSON を表示する方法。 1. ダッシュボードに移動します。 1. 上部のナビゲーションメニューで、**[ダッシュボード設定]** (歯車) アイコンをクリックします。 1. **[JSON モデル]** をクリックします。 **JSON フィールド** ユーザーが新しいダッシュボードを作成すると、新しいダッシュボード JSON オブジェクトが次のフィールドで初期化されます。 **注記** 次の JSON では、id は null として表示されます。これは、ダッシュボードが保存されるまで割り当てられるデフォルト値です。ダッシュボードを保存すると、整数値が `id` フィールドに割り当てられます。 ``` { "id": null, "uid": "cLV5GDCkz", "title": "New dashboard", "tags": [], "style": "dark", "timezone": "browser", "editable": true, "graphTooltip": 1, "panels": [], "time": { "from": "now-6h", "to": "now" }, "timepicker": { "time_options": [], "refresh_intervals": [] }, "templating": { "list": [] }, "annotations": { "list": [] }, "refresh": "5s", "schemaVersion": 17, "version": 0, "links": [] } ``` 以下は、ダッシュボード JSON の各フィールドについて説明します。 | 名前 | 使用方法 | | --- | --- | | **id** | ダッシュボードの一意の数値識別子 (db によって生成） | | **uid** | 誰でも生成できる一意のダッシュボード識別子。 文字列 (8～40) | | **title** | ダッシュボードの現在のタイトル | | **[タグ]** | ダッシュボードに関連付けられたタグ、文字列の配列 | | **Style** | *ダーク*や*ライト*などのダッシュボードのテーマ | | **timezone** | *utc* や*ブラウザ*などのダッシュボードのタイムゾーン | | **editable** | ダッシュボードが編集可能かどうか | | **graphTooltip** | 共有十字線またはツールチップなしの場合は 0 (デフォルト）、共有十字線の場合は 1、共有十字線と共有ツールチップの場合は 2 | | **time** | *過去 6 時間*や*過去 7 日*など、ダッシュボードの時間範囲 | | **timepicker** | timepicker メタデータ。詳細については「[timepicker セクション](#v9-dash-dashboard-json-model)」を参照してください。 | | **[テンプレート作成‭]** | メタデータのテンプレート作成。詳細については[[テンプレート作成セクション](#v9-dash-dashboard-json-model)を参照してください。 | | **annotations** | 注釈メタデータ。追加方法については「[注釈](v9-panels-annotate-visualizations.md)」を参照してください。 | | **[更新]** | 自動更新間隔 | | **schemaVersion** | JSON スキーマのバージョン (整数)。Grafana 更新がこのスキーマに変更を加えるたびに増加します。 | | **version** | ダッシュボードのバージョン (整数）。ダッシュボードが更新されるたびに増加します。 | | **panels** | パネル配列 (詳細については、以下を参照） | **パネル** パネルはダッシュボードの構成要素であり、データソースクエリ、グラフのタイプ、エイリアスなどで構成されます。パネル JSON は、JSON オブジェクトの配列で構成され、それぞれが異なるパネルを表します。ほとんどのフィールドはすべてのパネルで共通ですが、一部のフィールドはパネルタイプによって異なります。以下は、テキストパネルのパネル JSON の例です。 ``` "panels": [ { "type": "text", "title": "Panel Title", "gridPos": { "x": 0, "y": 0, "w": 12, "h": 9 }, "id": 4, "mode": "markdown", "content": "# title" } ``` **パネルのサイズと位置** gridPos プロパティは、グリッド座標のパネルサイズと位置を記述します。 + `w`: 1～24 (ダッシュボードの幅は 24 列に分割されます) + `h`: グリッドの高さの単位では、それぞれ 30 ピクセルを表します。 + `x`: `w` と同じ単位の x 位置。 + `y`: `h` と同じ単位の y 位置。 グリッドには負の重力があり、パネルの上に空のスペースがある場合にパネルを上に移動します。 **Timepicker** ``` "timepicker": { "collapse": false, "enable": true, "notice": false, "now": true, "refresh_intervals": [ "5s", "10s", "30s", "1m", "5m", "15m", "30m", "1h", "2h", "1d" ], "status": "Stable", "type": "timepicker" } ``` **[テンプレート作成‭]** `templating` フィールドには、保存された値を含むテンプレート変数の配列と、他のメタデータが含まれています。 ``` "templating": { "enable": true, "list": [ { "allFormat": "wildcard", "current": { "tags": [], "text": "prod", "value": "prod" }, "datasource": null, "includeAll": true, "name": "env", "options": [ { "selected": false, "text": "All", "value": "*" }, { "selected": false, "text": "stage", "value": "stage" }, { "selected": false, "text": "test", "value": "test" } ], "query": "tag_values(cpu.utilization.average,env)", "refresh": false, "type": "query" }, { "allFormat": "wildcard", "current": { "text": "apache", "value": "apache" }, "datasource": null, "includeAll": false, "multi": false, "multiFormat": "glob", "name": "app", "options": [ { "selected": true, "text": "tomcat", "value": "tomcat" }, { "selected": false, "text": "cassandra", "value": "cassandra" } ], "query": "tag_values(cpu.utilization.average,app)", "refresh": false, "regex": "", "type": "query" } ] } ```