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

# ダッシュボード
<a name="dashboard-overview"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 8.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。

 *ダッシュボード*は、1 つ以上の行に編成および配置された 1 つ以上のパネルのセットです。Amazon Managed Grafana には、さまざまなパネルが用意されています。Amazon Managed Grafana では、クエリを簡単に作成し、表示プロパティをカスタマイズして、お好みのダッシュボードを作成することができます。各パネルは、設定された任意のデータソースからのデータを操作できます。

## ダッシュボードの管理
<a name="manage-dashboards"></a>

 ダッシュボードの期間の制御は、ダッシュボードの右上にある [時間範囲コントロール](dashboard-time-range-controls.md) を使用します。

 ダッシュボードは、テンプレートや変数を使用することで、より動的でインタラクティブにすることができます。詳細については、「[テンプレートおよび変数](templates-and-variables.md)」を参照してください。

 ダッシュボードは、[‏注釈](dashboard-annotations.md) を使用してパネル間でイベントデータを表示できます。これにより、パネル内の時系列データを他のイベントと関連付けることができます。

 ダッシュボードはさまざまな方法で簡単に共有できます。詳細については、「[ダッシュボードの共有](share-a-dashboard.md)」を参照してください。

 ダッシュボードにはタグを付けることができます。ダッシュボードピッカーを使用することで、特定の組織内のすべてのダッシュボードを簡単に検索してアクセスできるようになります。

## [Rows] (行)
<a name="dashboard-rows"></a>

 *行*は、ダッシュボード内を論理的に区切るための要素です。行を使用してパネルをグループ化することができます。

 行の幅は常に 12 *ユニット*です。このユニットは、ブラウザの水平解像度に従って自動的にスケーリングされます。特定の幅を設定することで、行内のパネルの相対的な幅を制御できます。

 Amazon Managed Grafana は、画面サイズに応じて最適な表示を実現するために、ユニットの抽象化を使用しています。

**注記**  
 最大データポイント数 機能を使用すると、Amazon Managed Grafana は解像度や時間範囲に関係なく、必要な数のデータポイントを表示できます。

 行を折りたたむには、行タイトルを選択します。行が折りたたまれた状態でダッシュボードを保存するとその状態で保存され、行を展開するまでグラフは読み込まれません。

 繰り返し行機能を使用すると、選択したテンプレート変数に基づいて、パネルの行全体を動的に作成または削除することができます。

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

****  
このドキュメントのトピックは、**Grafana バージョン 8.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。

 注釈は、リッチイベントでグラフ上のポイントをマークする方法を提供します。注釈にカーソルを合わせると、イベントの説明とイベントタグを見ることができます。テキストフィールドには、より詳細な他のシステムへのリンクを含めることができます。

## ネイティブ注釈
<a name="native-annotations"></a>

 Amazon Managed Grafana には、ネイティブ注釈ストアと、グラフパネルから直接注釈イベントを追加する機能が付属しています。

## 注釈の追加
<a name="adding-annotations"></a>

 注釈を追加するには、[**Ctrl**] または [**Cmd**] を押して、注釈を追加する場所を選択します。注釈にタグを追加することで、他のダッシュボードから注釈を検索できるようになります。

### リージョン注釈の追加
<a name="adding-regions-events"></a>

 リージョンの注釈を作成するには、リージョンを選択しながら [**Ctrl**] または [**Cmd**] を押します。

### ビルトインクエリクエリ
<a name="annotation-built-in-query"></a>

 追加した注釈は表示されたままになります。これは、ビルトインの注釈クエリがすべてのダッシュボードに存在するためです。この注釈クエリは、現在のダッシュボードから発生するすべての注釈イベントを取得し、それらが作成されたパネルに表示されます。これには、アラート状態履歴の注釈が含まれます。注釈の取得と表示を停止するには、[**ダッシュボード設定**] (歯車) アイコン、[**注釈**] の順に選択し、`Annotations & Alerts (Built-in)` という名前のクエリを変更します。

 **[名前を付けて保存]** 機能を使用してダッシュボードをコピーすると、新しいダッシュボードに新しいダッシュボード ID が割り当てられるため、コピー元のダッシュボードで作成された注釈はコピーに表示されません。コピー元のダッシュボードの注釈にフィルタリングするタグがある場合は、新しい**[注釈クエリ]**を追加し、タグでフィルタリングすることで、コピーに注釈を表示できます。

### タグによるクエリ
<a name="annotation-query-by-tag"></a>

 `-- Grafana --` データソースを使用して **[～でフィルタリング]** を **タグ** に設定することで、ネイティブ注釈ストアから注釈を取得する新しい注釈クエリを作成できます。少なくとも 1 つのタグを指定します。例えば、`outages` という名前の注釈クエリ名を作成し、`outage` という名前のタグを指定します。このクエリは、(ダッシュボードまたは API 経由) で作成した `outage` タグを含むすべての注釈を表示します。

デフォルトでは、注釈クエリに複数のタグを追加すると、Amazon Managed Grafana は指定したすべてのタグを持つ注釈のみを表示します。指定したタグのうち、いずれか1つを含む注釈を表示するには、**[任意の一致]** をオンにします。

 Amazon Managed Grafana では、タグクエリでテンプレート変数を使用できます。例えば、さまざまなサービスの統計を表示するダッシュボードと、表示するサービスを制御するテンプレート変数がある場合は、注釈クエリで同じテンプレート変数を使用して、それらのサービスの注釈のみを表示できます。

## その他のデータソースのクエリ
<a name="querying-other-data-sources"></a>

 注釈イベントは、注釈クエリを使用して取得されます。ダッシュボードに新しい注釈クエリを追加するには、[**ダッシュボード設定**] (歯車) アイコン、[`Annotations`]、[**新規**] の順に選択します。

 注釈クエリの名前を指定します。この名前は、このクエリの注釈イベントの表示または非表示を切り替えるチェックボックスに表示されます。例えば、2 つの注釈クエリ(`Deploys` と `Outages`) があるとします。チェックボックスのオンとオフを切り替えることで、表示する注釈を指定できます。

### 注釈クエリの詳細
<a name="annotation-query-details"></a>

 注釈クエリオプションは、データソースごとに異なります。
+ [Graphite クエリエディタを使用した注釈](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-graphite-in-AMG.html#graphite-annotations)
+ [OpenSearch データソースを使用した注釈](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/ES-use-datasource.html#ES-annotations)
+ [Prometheus を使用した注釈](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-prometheus-datasource.html#p-annotations)
+ [[MySQL を使用した注釈]](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-mysql-in-AMG.html#mysql-annotations)
+ [[PostgreSQL を使用した注釈]](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-postgresql-in-AMG.html#postgresql-annotations)

# ダッシュボードのフォルダ
<a name="dashboard-folders"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 8.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。

 フォルダを使用して、ダッシュボードを整理してグループ化することができます。これは、ダッシュボードが数多くある場合や、複数のチームが同じ Grafana ワークスペースを使用している場合に重宝します。

## フォルダの作成
<a name="how-to-create-a-folder"></a>

フォルダを作成するには、以下のいずれかの操作を実行します。
+  サイドメニューの [\$1] アイコンから **[フォルダの作成]** リンクを選択します。
+  [**ダッシュボードの管理**] ページで、[**フォルダの作成**] ボタンを選択します。

 [**フォルダの作成**] ページで、フォルダの一意の名前を入力して [**作成**] を選択します。

ダッシュボードの保存先には、既存のフォルダを選択するか、新しいフォルダを作成して選択することができます。

## ダッシュボードの管理
<a name="folders-manage-dashboards"></a>

 [**ダッシュボードの管理**] ページでは、さまざまなタスクを実行できます。
+  フォルダを作成します。
+  ダッシュボードを作成します。
+  ダッシュボードをフォルダに移動します。
+  複数のダッシュボードを削除します。
+  フォルダページに移動します (フォルダまたはそのダッシュボードのアクセス権限を設定できます)。

## ダッシュボードフォルダページ
<a name="dashboard-folder-page"></a>

 ダッシュボードフォルダページを開くには、[検索結果] または [ダッシュボードの管理] ページのダッシュボード一覧のフォルダにカーソルを合わせると表示される歯車アイコンを選択します。

 ダッシュボードフォルダページは、ダッシュボードの管理ページと似ています。ダッシュボードフォルダページで、以下の操作を行うことができます。
+  フォルダ内のダッシュボードを移動または削除する。
+  フォルダの名前の変更 ([**設定**] タブで)。
+  フォルダのアクセス権限の設定 (フォルダ内のダッシュボードによって継承されます)。

## 権限
<a name="folder-permissions"></a>

 アクセス許可はフォルダに割り当てることができ、そのフォルダに含まれるダッシュボードがその権限を継承します。アクセスコントロールリスト (ACL) は、**組織ロール **、**チーム**、個人**ユーザー**に権限を割り当てるために使用します。詳細については、「[ダッシュボードおよびフォルダのアクセス権限](dashboard-and-folder-permissions.md)」を参照してください。

# プレイリスト
<a name="dashboard-playlist"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 8.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。

 プレイリストは、ダッシュボードを順番に表示するためのリストです。プレイリストを使用して状況認識を高めたり、チームや訪問者にメトリクスを提示することができます。

 Amazon Managed Grafana は、解像度に合わせてダッシュボードを自動的に拡大縮小し、大画面にも対応します。

 **プレイリスト**機能には、サイドメニューの**ダッシュボード**サブメニューからアクセスできます。

## プレイリストの作成
<a name="create-a-playlist"></a>

 プレイリストは、ダッシュボードを順番に、一定の時間間隔で表示します。

1.  **プレイリスト**機能へのアクセスは、サイドメニューにカーソルを合わせます。

1.  **[プレイリスト]** を選択します。

1.  **[新しいプレイリスト]** を選択します。

1.  **[名前]** ボックスに、プレイリスト名を入力します。

1.  **[間隔]** テキストボックスに時間間隔を入力します。

   時間間隔は、Amazon Managed Grafana が順番に表示するプレイリストの各ダッシュボードを表示したままにする時間です。

1.  プレイリストに追加したいダッシュボードの横にある、**[プレイリストに追加]** を選択します。

1.  **[作成]** を選択します。

## プレイリストの編集
<a name="edit-a-playlist"></a>

 プレイリストは、作成中または保存後に編集できます。

1.  プレイリスト機能へのアクセスは、サイドメニューにカーソルを合わせます。

1.  **[プレイリスト]** を選択します。

1.  編集するプレイリストを選択します。

### プレイリスト名の編集
<a name="edit-the-name-of-a-playlist"></a>

1. **[名前]** テキストボックスを選択します。

1.  名前を編集します。

1.  **[保存]** を選択して変更を保存します。

### プレイリストの間隔の編集
<a name="edit-the-interval-of-a-playlist"></a>

1.  **[間隔]** テキストボックスを選択します。

1.  間隔を編集します。

1.  **[保存]** を選択して変更を保存します。

### プレイリストにダッシュボードを追加する
<a name="add-a-dashboard-to-a-playlist"></a>

1.  プレイリストに追加したい各ダッシュボードの横にある、**[プレイリストに追加]** を選択します。

1.  **[保存]** を選択して変更を保存します。

### 追加するダッシュボードの検索
<a name="search-for-a-dashboard-to-add"></a>

1. **[ダッシュボードの追加]** で、**[名前でダッシュボードを検索]** テキストボックスを選択します。

1.  名前または正規表現を入力します。

1. 必要に応じて、スター付きの状態やタグで結果を絞り込むことができます。デフォルトでは、スター付きのダッシュボードがプレイリストに追加できるオプションとして表示されます。

1.  **[保存]** を選択して変更を保存します。

### ダッシュボードの順序の並べ替え
<a name="rearrange-dashboard-order"></a>

1.  移動させるダッシュボードの横にある上矢印または下矢印を選択します。

1.  **[保存]** を選択して変更を保存します。

### ダッシュボードの削除
<a name="remove-a-dashboard"></a>

1.  プレイリストからダッシュボードを削除するには、x アイコンを選択します。

1.  **[保存]** を選択して変更を保存します。

### プレイリストの削除
<a name="delete-a-playlist"></a>

1.  **[プレイリスト]** を選択します。

1.  削除したいプレイリストの横にある x アイコンを選択します。

## プレイリストの保存
<a name="save-a-playlist"></a>

 プレイリストを保存すると、**プレイリスト**ページに追加され、そこで再生を開始できます。プレイリストを保存する前に、表示させたいすべてのダッシュボードが追加されていることを確認してください。

1.  **プレイリスト**機能へのアクセスは、サイドメニューにカーソルを合わせます。

1.  **[プレイリスト]** を選択します。

1.  プレイリストを選択します。

1.  プレイリストを編集します。

   プレイリストに**名前**、**間隔**が設定されており、少なくとも 1 つの**ダッシュボード**が追加されていることを確認します。

1.  **[保存]** を選択します。

## プレイリストの開始
<a name="start-a-playlist"></a>

 プレイリストの開始は 5 種類のビューモードから選択できます。モードによって、ダッシュボードへのメニューとナビゲーションバーの表示方法が異なります。

 デフォルトでは、各ダッシュボードは**間隔**フィールド (プレイリストの作成時または編集時に設定可能) に入力された時間表示されます。プレイリスト開始後は、画面上部のナビバーで制御します。

1.  **[ダッシュボード]**]メニューで、**[プレイリスト]**] を選択します。

1.  開始するプレイリストの横にある [**プレイリストの開始**] を選択します。

1.  ドロップダウンリストから、次のいずれかの表示モードを選択します。
   +  **[通常モード]** 
     +  サイドメニューは表示されたままです。
     +  ナビゲーションバー、行、パネルのコントロールが画面の上部に表示されます。
   +  **TV モード** 
     +  サイドメニューは非表示 (削除) されます。
     +  ナビゲーションバー、行、パネルのコントロールが画面の上部に表示されます。
     +  1 分間操作しないと、TV モードが自動的にオンになります。
     +  TV モードを手動でオンにするには、ショートカットとして **d v** を順番に押すか、ダッシュボード URL に パラメータ `?inactive` を追加します。
     +  マウスを動かしたり何かキーボードのキーを押すことで、TV モードを無効にできます。
   +  **TV モード (自動フィットパネル付き)** 
     +  サイドメニューは非表示 (削除) されます。
     +  ナビゲーションバー、行、パネルのコントロールが画面の上部に表示されます。
     +  ダッシュボードパネルは、画面上のスペースを最適化するために自動的に調整されます。
   +  **キオスクモード** 
     +  サイドメニュー、ナビゲーションバー、行、およびパネルコントロールが、完全に非表示 (表示から削除) になります。
     +  プレイリストの起動後、 ショートカットとして **d v** を順番に押すと、手動で Kiosk モードをオンにできます。
     +  このショートカットを使用して、手動で Kiosk モードをオフにできます。
   +  **キオスクモード (自動フィットパネル付き)** 
     +  サイドメニュー、ナビゲーションバー、行、およびパネルコントロールが、完全に非表示 (表示から削除) になります。
     +  ダッシュボードパネルは、画面上のスペースを最適化するために自動的に調整されます。

## プレイリストの制御
<a name="control-a-playlist"></a>

 プレイリストの開始後は、画面上部のナビゲーションバーを使用して、**通常**モードまたは**テレビ**モードでプレイリストを制御できます。


|  ボタン  |  結果  | 
| --- | --- | 
|  次へ (二重右矢印)  |  次のダッシュボードに進みます。 | 
|  戻る (左矢印）  |  前のダッシュボードに戻ります。 | 
|  停止 (四角)  |  プレイリストを終了し、現在のダッシュボードに戻ります。 | 
|  サイクルビューモード (モニターアイコン)  |  ダッシュボードの表示を現在とは違うビューモードに変更します。 | 
|  時間範囲  | 指定した時間範囲内のデータを表示します。ドロップダウン矢印を使用して、過去 5 分から 5 年前、または表示するカスタム時間範囲を設定します。 | 
|  更新 (円矢印)  |  ダッシュボードを再読み込みして、最新のデータを表示します。ドロップダウン矢印を使用して、5 秒ごとに自動的にリロードするように設定することもできます。 | 

 キーボードの **Esc** でもプレイリストを停止できます。

## ビューモードでプレイリストを共有する
<a name="share-a-playlist-in-a-view-mode"></a>

お好みのビューモードで URL をコピーし、宛先に URL を貼り付けることで、プレイリストを共有できます。

1.  **[ダッシュボード]**]メニューから、**[プレイリスト]** を選択します。

1.  共有するプレイリストの横にある [**プレイリストの開始**] を選択し、お好みのビューモードを選択します。

1.  [**リンクアドレスをコピー**] を選択すると、リンクがクリップボードにコピーされます。

    例えば、Grafana Play サイトのキオスクモードのプレイリスト URL は `https://play.grafana.org/d/000000010/annotations?orgId=1&kiosk` のようになります 

1.  送信先に URL を貼り付けます。

# ダッシュボードの検索
<a name="dashboard-search"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 8.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。

 ダッシュボードは、ダッシュボード名で検索することができます。また、タグ (複数可) やスター付きの状態でフィルタリングすることができます。ダッシュボードの検索は、ダッシュボード上部のナビゲーションバーにあるダッシュボードピッカーから行うことができます。ダッシュボードの検索は、ショートカット「**F**」でも開きます。

キーボードのみを使用する場合、キーボードの矢印キーで目的のダッシュボードまで検索結果を移動して「**Enter**」キーを押して開くことができます。

## ダッシュボード名でフィルタリング
<a name="find-by-dashboard-name"></a>

検索バーにダッシュボード名の一部を入力します。入力すると、文字列の部分一致の検索結果がリアルタイムで返されます。

ダッシュボードの検索機能:
+ リアルタイム
+ 大文字と小文字は区別されません。
+  保存済みダッシュボードとファイルベースのダッシュボード全体

## タグでフィルタリング
<a name="filter-by-tags"></a>

 ダッシュボードの数が増えるほど、タグをつけることで効果的に整理することができます。タグはダッシュボードの [**設定**] で追加および管理できます。

 ダッシュボードの一覧をタグでフィルタリングするには、右側の列に表示されるタグを選択します。選択するタグを増やすことで、一覧をさらにフィルタリングできます。

**[タグでフィルタリング]**ドロップダウンメニューを選択すると、使用可能なすべてのタグの一覧を見ることができます。タグを選択すると、ダッシュボードの検索結果がリアルタイムにフィルタリングされます。

キーボードのみを使用する場合、「**Tab**」を押してタグリンクにカーソルを移動し、下矢印キーを押してタグを検索し、「**Enter**」を押してタグを選択します。

**注記**  
 複数のタグを選択すると、Amazon Managed Grafana は選択したすべてのタグを含むダッシュボードを表示します。

# ダッシュボードの共有
<a name="share-a-dashboard"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 8.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。

 ダッシュボードを共有するには、上部のナビゲーションバーで **[ダッシュボードの共有]** (共有アイコン) を選択します。**[共有]** ダイアログボックスが開き、現在選択されている時間範囲とテンプレート変数を含む現在のダッシュボードへのリンクを取得できます。ダッシュボードに変更を加えた場合は、リンクをコピーする前に、必ずこれらの変更を保存してください。

## ダッシュボードスナップショット
<a name="dashboard-snapshot"></a>

 ダッシュボードスナップショットは、インタラクティブダッシュボードを即時にパブリックに共有する方法です。スナップショットを作成すると、Amazon Managed Grafana はクエリ (メトリクス、テンプレート、注釈) やパネルリンクなどの機密データを消去し、ダッシュボードに埋め込まれた可視メトリクスデータとシリーズ名のみが残されます。ダッシュボードスナップショットには、リンクがあり URL にアクセスできるすべてのユーザーがアクセスできます。

## スナップショットの発行
<a name="publish-snapshots"></a>

 スナップショットはローカルインスタンスに発行できます。

# パネルの共有
<a name="dashboard-share-a-panel"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 8.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。

 パネルタイトルを選択してパネルメニューを開き、パネルメニューで [**共有**] を選択して**パネル共有**ダイアログボックスを開きます。コピーしたリンクには現在の時間範囲と選択したテンプレート変数が設定されるため、このパネルに正確に移動できます。

# 時間範囲コントロール
<a name="dashboard-time-range-controls"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 8.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。

 Amazon Managed Grafana では、視覚化されるデータの時間範囲を制御できるいくつかの方法がダッシュボードレベルとパネルレベルの両方に用意されています。

 このトピックでは、サポートされている時間単位と相対範囲、一般的な時間コントロール、ダッシュボード全体の時間設定、パネル固有の時間設定について説明します。

**注記**  
時間コントロールの使用には、データに時間列が含まれている必要があります。時間列を含める方法の詳細については、特定の「[データソース](AMG-data-sources.md)」のドキュメントを参照してください。

## 時間単位と相対範囲
<a name="time-units-and-relative-ranges"></a>

 以下の時間単位がサポートされています。
+ `s` (秒)
+ `m` (分)
+ `h` (時間)
+ `d` (日数)
+ `w` (週数)
+ `M` (月数)
+ `y` (年数)

 マイナス演算子を使用すると、現在の時間を基準に過去を指定することができます。単位の全期間 (日、週、月など) を表示するには、`/<time unit>` を追加します。

 プラス演算子を使用すると、現在の時間を基準に未来を指定することができます。この機能を使用して、将来の予測データを確認できます。

 次に例を示します。


|  相対範囲の例  |  から  |  To  | 
| --- | --- | --- | 
|  過去 5 分間  |  now-5m  |  now  | 
|  今日のこれまでのところ  |  now/d  |  now  | 
|  今週  |  now/w  |  now/w  | 
|  今週始めから現在まで  |  now/w  |  now  | 
|  前月  |  now-1M/M  |  now-1M/M  | 

## 一般的な時間範囲コントロール
<a name="common-time-range-controls"></a>

 ダッシュボードとパネルの時間コントロールには、以下のオプションを含む共通のユーザーインターフェイスがあります。

### 現在の時間範囲
<a name="current-time-range"></a>

 現在の時間範囲 (別名*タイムピッカー*)は、そのダッシュボードまたはパネルに現在表示されている時間範囲を示します。

 フィールドにカーソルを合わせると、その範囲内の正確なタイムスタンプとソース (ローカルブラウザなど) が表示されます。

 時間範囲を変更するには、現在の時間範囲を選択します。現在の時間は、過去 15 分などの*相対時間範囲*や、`2020-05-14 00:00:00 to 2020-05-15 23:59:59` のような*絶対時間範囲*で変更できます。

### 相対時間範囲
<a name="relative-time-range"></a>

 **[相対時間範囲]** リストから相対時間範囲を選択します。相対時間範囲の例をいくつか示します。
+  過去 30 分 
+  過去 12 時間 
+  過去 7 日間 
+  過去 2 年間 
+  昨日 
+  一昨日 
+  先週のこの日 
+  現在まで 
+  今週始めから現在まで 
+  今月始めから現在まで 

### 絶対時間範囲
<a name="absolute-time-range"></a>

 絶対時間範囲は、次の 2 つの方法のいずれかで設定します。
+  **[開始]** フィールドと **[終了]** フィールドに値を入力します。正確な時間値または `now-24h` などの相対値を入力し、**[時間範囲の適用]** を選択します。
+  **[開始]** または **[終了]** フィールドを選択します。Amazon Managed Grafana にカレンダーが表示されます。現在の時間範囲として使用したい日付を選択し、**[時間範囲の適用]** を選択します。

 Amazon Managed Grafana には、最近使用した絶対範囲も表示されます。

### ズームアウト (Cmd\$1Z または Ctrl\$1Z)
<a name="zoom-out-cmdz-or-ctrlz"></a>

 ダッシュボードまたはパネルの視覚的表現でより大きな時間範囲を表示するには、[**時間範囲のズームアウト**] アイコンを選択します。

### ズームイン (グラフに対してのみ)
<a name="zoom-in-only-applicable-to-graph-visualizations"></a>

 グラフ上でドラッグして表示する時間範囲を選択します。

### ダッシュボードの更新
<a name="refresh-dashboard"></a>

 [**ダッシュボードの更新**] アイコンを選択すると、ダッシュボード上のすべてのクエリが即座に実行され、視覚的表現が更新されます。Amazon Managed Grafana は、新しい更新が開始されると、保留中のリクエストをすべてキャンセルします。

 デフォルトでは、Amazon Managed Grafana はダッシュボードを自動的に更新しません。クエリは、パネル設定に従って独自のスケジュールで実行されます。[**ダッシュボードの更新**] アイコンの横にある下矢印を選択し、更新間隔を選択することで、ダッシュボードを定期的に更新することができます。

## ダッシュボードの時間設定
<a name="dashboard-time-settings"></a>

 時間設定はダッシュボードごとに保存されます。

 画面上部の**ダッシュボード設定** (歯車) アイコンを選択すると、ダッシュボードの時間設定が開きます。設定は、[**全般**] タブの「**時間オプション**」セクションで行います。
+  **[タイムゾーン]** – モニタリングするサービスまたはシステムのローカルタイムゾーン。これは、複数のタイムゾーンで動作するシステムまたはサービスを監視する場合に役立ちます。
  +  **[デフォルト]** – ユーザープロファイル、チーム、または組織にデフォルトで設定されているタイムゾーン。ユーザープロファイル、ユーザーが所属するチーム、または組織にタイムゾーンが指定されていない場合、Amazon Managed Grafana はローカルブラウザの時間を使用します。
  +  **[ブラウザの時間]** – 使用中のブラウザに設定されたタイムゾーン。これは通常、コンピュータに設定されているタイムゾーンです。
  +  **[協定世界時]** – UTC を含む標準の ISO 8601 タイムゾーン。詳細については、「[タイムゾーン一覧](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)」を参照してください。
+  **[自動更新]** – 相対時間と自動更新設定 (カスタマイズ可能オプション)。入力はカンマで区切りで、いずれも有効な時間単位である必要があります。
+  **現在時刻の遅延-** - `now` 値をオーバーライドする時間遅延値。通常、この機能は、データ集約の既知の遅延に対応するために null 値を回避するために使用されます。
+  **[タイムピッカーを非表示]** – タイムピッカーを非表示にします。

## パネル時間のオーバーライドと時間のシフト
<a name="panel-time-overrides-and-timeshift"></a>

 [クエリオプション](panel-queries.md#query-options) では、個々のパネルに対して相対時間範囲を上書きして、ダッシュボードの上部ナビゲーションバーにあるタイムピッカーで選択されているものと異なる時間範囲に設定することができます。これにより、異なる期間または日数のメトリクスを同時に表示することができます。

## URL の使用による時間範囲の制御
<a name="control-the-time-range-using-a-url"></a>

 ダッシュボード URL に次のクエリパラメータを指定すると、ダッシュボードの時間範囲を制御できます。
+  `from` – エポックミリ秒で指定された時間範囲の下限、または相対時間を定義します。詳細については、「[相対時間範囲](#relative-time-range)」を参照してください。
+  `to` – エポックミリ秒で指定された時間範囲の上限、または相対時間を定義します。詳細については、「[相対時間範囲](#relative-time-range)」を参照してください。
+  `time` および `time.window` — `time-time.window/2` から `time+time.window/2` までの時間範囲を定義します。両方のパラメータは、ミリ秒単位で指定する必要があります。例えば、`?time=1500000000000&time.window=10000` は 1499999995000 から 1500000005000 までの 10 秒の時間範囲になります。

# ダッシュボードのエクスポートとインポート
<a name="dashboard-export-and-import"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 8.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。

 Amazon Managed Grafana のダッシュボードは、UI または [HTTP API] から簡単にエクスポートおよびインポートすることができます。

## ダッシュボードのエクスポート
<a name="exporting-a-dashboard"></a>

 ダッシュボードは、後でダッシュボードをインポートするために必要なレイアウト、変数、スタイル、データソース、クエリなどすべてを含めた Amazon Managed Grafana JSON 形式でエクスポートされます。

 エクスポート機能は、ダッシュボードメニューの [共有] ボタンを選択して開いた共有ウィンドウから利用できます。

### ダッシュボードをポータブルにする
<a name="making-a-dashboard-portable"></a>

 他のユーザーが使用できるようにダッシュボードをエクスポートする場合、メトリクスプレフィックス (定数変数を使用) やサーバー名などのテンプレート変数を追加できます。

 `Constant` タイプのテンプレート変数は、ダッシュボードで自動的に非表示になります。ダッシュボードがインポートされる際にも、必要な入力として追加されます。テンプレート作成とテンプレート変数の詳細については、「[テンプレートおよび変数](templates-and-variables.md)」を参照してください。

## ダッシュボードのインポート
<a name="importing-a-dashboard"></a>

 ダッシュボードをインポートするには、サイドメニューの [\$1] アイコン、**[インポート]** の順に選択します。

 ダッシュボードの JSON ファイルをアップロードしたり、ダッシュボードの URL を貼り付けたり、ダッシュボードの JSON テキストをテキスト領域に直接貼り付けたりすることができます。

 インポートプロセスのステップ 2 では、ダッシュボードの名前を変更したり、ダッシュボードで使用するデータソースを指定したり、メトリクスプレフィックス (ダッシュボードが使用している場合) を指定することができます。

## Grafana.com でダッシュボードを探す
<a name="discover-dashboards-on-grafana.com"></a>

 [Grafana.com/dashboards](https://grafana.com/dashboards) で一般的なサーバーアプリケーションのダッシュボードを検索します。

# ダッシュボードのバージョン履歴
<a name="dashboard-version-history"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 8.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。

 ダッシュボードのバージョンを保存するたびに、以前のバージョンのダッシュボードが失われないように、そのバージョンのコピーが保存されます。これらのバージョンの一覧は、[**ダッシュボード設定**] を選択し、左側のメニューで [**バージョン**] を選択することで確認できます。

 ダッシュボードのバージョン履歴機能では、以前に保存したダッシュボードバージョンを比較して復元できます。

## 2 つのダッシュボードバージョンの比較
<a name="comparing-two-dashboard-versions"></a>

 2 つのダッシュボードバージョンを比較するには、比較するリストから 2 つのバージョンを選択します。2 つのバージョンを選択後、[**バージョンを比較**] を選択すると差分ビューが開きます。デフォルトでは、次の画像のように、変更の概要がテキストで表示されます。

 ダッシュボードを表す未加工の JSON の差分を表示するには、**[JSON の差分を表示]** を選択します。

 比較対象の以前のバージョンに復元するには、[**バージョン <x> に復元**] を選択します。

## 以前に保存したダッシュボードバージョンへの復元
<a name="restoring-to-a-previously-saved-dashboard-version"></a>

 以前に保存したダッシュボードバージョンに復元する必要がある場合、ダッシュボードバージョンリストの行の右側にある [復元] ボタンを選択するか、差分ビューに表示される [**バージョン<x>に復元**] を選択します。復元を選択すると、復元を確認するポップアップボックスが表示されます。

 以前のバージョンに復元すると、以前のバージョンとまったく同じデータを含みますが、バージョン番号が異なる新しいバージョンが作成されます。これは [**Notes**] (注記) 列に表示されます。これにより、以前のダッシュボードバージョンが変更の影響を受けなくなります。

# キーボードショートカット
<a name="keyboard-shortcuts"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 8.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。

 Amazon Managed Grafana では多数のキーボードショートカットを利用できます。ご使用の Amazon Managed Grafana のバージョンで使用可能なすべてのキーボードショートカットを表示するには、キーボードで **Shift \$1 ?** を押します。

 **Amazon Managed Grafana には次の一般的なショートカットが含まれています。**
+  **Ctrl\$1S** では現在のダッシュボードを保存します。
+  **Ctrl\$1F** ではダッシュボードファインダー/検索が開きます。
+  **Ctrl\$1H** ではすべてのコントロールが非表示になります (コントロールの非表示は TV のディスプレイでうまく機能します)。
+  **Escape** では全画面モードまたは編集モードのときにはグラフを終了します。

# ダッシュボード JSON モデル
<a name="dashboard-json-model"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 8.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。

 Amazon Managed Grafana のダッシュボードは、ダッシュボードのメタデータを保存する JSON オブジェクトによって表されます。ダッシュボードメタデータには、ダッシュボードプロパティ、パネルからのメタデータ、テンプレート変数、パネルクエリが含まれます。

**ダッシュボードの JSON を表示する方法**

1.  ダッシュボードを開きます。

1.  上部のナビゲーションバーで、**ダッシュボードの管理**を選択します。

1.  ドロップダウンメニューから **[JSON の表示]** を選択します。

## JSON フィールド
<a name="dashboard-json-fields"></a>

 ユーザーが新しいダッシュボードを作成すると、新しいダッシュボード JSON オブジェクトが次のフィールドで初期化されます。

**注記**  
 次の JSON では、`id` は `null` として表示されます。これは、ダッシュボードが保存されるまで割り当てられるデフォルト値です。ダッシュボードを保存すると、整数値が `id` フィールドに割り当てられます。

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "timezone": "browser",
  "editable": true,
  "hideControls": false,
  "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  |  ダッシュボードの一意の数値識別子 (データベースによって生成）  | 
|  uid  |  誰でも生成できる一意のダッシュボード識別子。uid は 8～40 文字の文字列です。 | 
|  title  |  ダッシュボードの現在のタイトル。 | 
|  [タグ]  |  ダッシュボードに関連付けられているタグ。JSON では、タグは文字列の配列です。 | 
|  style  |  ダッシュボードのテーマ (dark や light など)。 | 
|  timezone  |  ダッシュボードのタイムゾーン (utc または browser)。 | 
|  editable  |  ダッシュボード編集の可否。 | 
|  graphTooltip  |  ツールチップのスタイル。[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/grafana/latest/userguide/dashboard-json-model.html)  | 
|  time  |  ダッシュボードの時間範囲 (過去 6 時間、過去 7 日など)。 | 
|  timepicker  |  タイムピッカーメタデータ。詳細については、「[タイムピッカー](#dashboard-json-timepicker)」を参照してください。 | 
|  templating  |  テンプレートメタデータ。詳細については、「[テンプレートおよび変数](templates-and-variables.md)」を参照してください。 | 
|  annotations  |  注釈メタデータ。詳細については、「[‏注釈](dashboard-annotations.md)」を参照してください。 | 
|  refresh  |  自動更新間隔。 | 
|  schemaVersion  |  JSON スキーマのバージョン (整数)。Amazon Managed Grafana 更新でスキーマが変更されるたびに増加します。 | 
|  version  |  ダッシュボードのバージョン (整数)。ダッシュボードが更新されるたびに増加します。 | 
|  panels  |  パネル配列。詳細については、「[パネル](#dashboard-JSON-panels)」を参照してください。 | 

## パネル
<a name="dashboard-JSON-panels"></a>

 パネルはダッシュボードの構成要素であり、データソースクエリ、グラフのタイプ、エイリアス、その他のデータなどで構成されます。パネル JSON は、JSON オブジェクトの配列で構成され、それぞれが異なるパネルを表します。ほとんどのフィールドはすべてのパネルで共通ですが、一部のフィールドはパネルタイプによって異なります。以下は、テキストパネルのパネル JSON の例です。

```
"panels": [
  {
    "type": "text",
    "title": "Panel Title",
    "gridPos": {
      "x": 0,
      "y": 0,
      "w": 12,
      "h": 9
    },
    "id": 4,
    "mode": "markdown",
    "content": "# title"
  }
```

### パネルのサイズと位置
<a name="panel-size-and-position"></a>

 `gridPos` プロパティは、グリッド座標のパネルサイズと位置を記述します。
+  `w` – 1～24。ダッシュボードの幅は 24 列に分割されます。
+  `h` – グリッドの高さの単位。各グリッド高さの単位では 30 ピクセルを表します。
+  `x` – x 位置。x 位置は、`w` と同じ列単位を使用します。
+  `y` – Y 位置。y 位置は、`h` と同じグリッド高単位を使用します。

 グリッドには負の重力があり、パネルの上に空のスペースがある場合にパネルを上に移動します。

### タイムピッカー
<a name="dashboard-json-timepicker"></a>

`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"
  }
```

 `timepicker` の使用方法の詳細を以下の表に示します。


|  名前  |  使用方法  | 
| --- | --- | 
|  collapse  |  timepicker が折りたたまれているかどうか  | 
|  enable  |  timepicker がアクティブ化されているかどうか  | 
|  notice  |  TODO  | 
|  now  |  TODO  | 
|  refresh\$1intervals  |  TODO  | 
|  status  |  TODO  | 
|  type  |  TODO  | 

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

 `templating` フィールドには、保存された値やその他のメタデータを含むテンプレート変数の配列が格納されています。`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"
      }
    ]
  }
```

 テンプレートセクションの使用方法の詳細を以下の表に示します。


|  名前  |  使用方法  | 
| --- | --- | 
|  enable  |  テンプレートが有効になっているかどうか。 | 
|  list  |  1 つのテンプレート変数を表すオブジェクトの配列  | 
|  allFormat  |  データソースからすべての値を取得する際に使用する形式 (例: wildcard、glob、regex、pipe)。 | 
|  current  |  ダッシュボードに現在選択されている変数テキスト/値を表示します  | 
|  データソース  |  変数のデータソースを表示します  | 
|  includeAll  |  すべての値オプションが使用可能かどうか  | 
|  multi  |  変数値リストから複数の値を選択できるかどうか  | 
|  multiFormat  |  データソースから時系列を取得する際に使用する形式  | 
|  [名前]  |  変数の名前。 | 
|  options:  |  ダッシュボードで選択できる可変テキスト/値のペアの配列  | 
|  query  |  変数の値の取得に使用されるデータソースクエリ  | 
|  [更新]  |  TODO  | 
|  [正規表現]  |  TODO  | 
|  type  |  変数のタイプ (custom、query、または interval)。 | 

# スクリプト化ダッシュボード
<a name="scripted-dashboards"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 8.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。

**警告**  
 この機能は廃止されており、将来のリリースでは削除されます。

 定義されたパターンで変更されるメトリクス名 (新しいサーバーなど) が多数ある場合、常に新しいダッシュボードを作成するには時間がかかる場合があります。

 スクリプト化ダッシュボードでは、JavaScript を使用してダッシュボードを動的に作成できます。Grafana のインストールフォルダの `public/dashboards/` の下に、`scripted.js` という名前のファイルがあります。このファイルにはスクリプト化ダッシュボードの例が含まれています。URL `http://grafana_url/dashboard/script/scripted.js?rows=3&name=myName` を使用してアクセスできます。

 `scripted.js` を開くと、`ARGS` 変数から URL パラメータを読み取ってから行とパネルを追加する方法を確認できます。

## 例: scripted.js
<a name="example"></a>

```
var seriesName = 'argName';

if (!_.isUndefined(ARGS.name)) {
  seriesName = ARGS.name;
}

dashboard.panels.push({
  title: 'Events',
  type: 'graph',
  fill: 1,
  linewidth: 2,
  gridPos: {
    h: 10,
    w: 24,
    x: 0,
    y: 10,
  },
  targets: [
    {
      target: "randomWalk('" + seriesName + "')",
    },
    {
      target: "randomWalk('random walk2')",
    },
  ],
});

return dashboard;
```

## その他の の例
<a name="more-examples"></a>

 その他の例は、Grafana インストールの `public/dashboards/` ディレクトリに収められています。