Oracle Cloud Infrastructureドキュメント

Grafanaプラグイン

このトピックでは、Oracle Cloud Infrastructure Data Source for Grafanaのインストール、構成および使用の手順を説明します。

このトピックでは、Grafanaプラグインとも呼ばれるOracle Cloud Infrastructure Data Source for Grafanaのインストール、構成および使用の手順を説明します。

Grafanaプラグインの概要

Grafanaは、時系列データ(メトリック)の分析とモニタリングに使用できる、ビジュアライゼーションとアラートのためのオープンソース・ツールです。Oracle Cloud Infrastructure Monitoringのメトリックはコンソールでメトリック・チャートに表示できますが、Oracle Cloud Infrastructure Data Source for Grafana (Grafanaプラグイン)を使用すると、複数のプロバイダにまたがっているリソースのメトリックを1つのGrafanaダッシュボードで表示できます。

Grafanaプラグインを使用するための前提条件

  • Oracle Cloud Infrastructureアカウント。
  • そのアカウントのユーザー。それらのコンパートメントのリソースの操作に必要な権限を付与するIAMポリシーがあるセキュリティ・グループに含まれる。このポリシーでは、メトリックを生成するメトリック・ネームスペース(コンピュートなど)と、関連するリソース(一連のコンピューティング・インスタンスなど)へのアクセス権を付与する必要があります。アクションを実行しようとしたときに、権限がない、または認可されていないというメッセージが表示された場合は、付与されているアクセスのタイプと作業するコンパートメント を管理者に確認してください。管理者: グループにメトリックへのアクセス権を付与する共通ポリシーについては、グループのメトリック・アクセスを参照してください。APIコールを行うリソース(インスタンスなど)を認可するには、一致ルールを使用してそれらのリソースを動的グループに追加し、その動的グループにメトリックへのアクセスを許可するポリシーを作成します。コンパートメントにまたがるアクセスを許可するには、テナンシにポリシーを作成します。ポリシー継承の概念に基づいて、指定された動的グループ内のインスタンスが、すべてのコンパートメントのメトリックにアクセスできます。アクセス範囲を絞り込んで特定のコンパートメントに限定するには、テナンシのかわりにコンパートメントを指定します。リソースのメトリック・アクセスを参照してください。
  • コンピュート・インスタンス: メトリックを生成するには、コンピュート・インスタンスのモニタリング・プラグインがインスタンスで有効になっており、プラグインが実行されている必要があります。また、モニタリング・サービスにメトリックを送信するために、インスタンスにサービス・ゲートウェイまたはパブリックIPアドレスが必要です。詳細は、コンピュート・インスタンスのモニタリングの有効化を参照してください。
  • 必要なキーおよびOracle Cloud Infrastructure ID (OCIDs)。ガイダンスは、必要なキーとOCIDを参照してください。

Grafanaプラグインのダウンロードとインストール

ノート

Grafanaプラグインをインストールする前に、Grafanaをインストールする必要があります。バージョン3.0以降が必要です。

メトリック・アクセスの認証は、Grafanaの実行場所によって異なります。GrafanaをOracle Cloud Infrastructure外部のローカル・マシンで実行する場合は、モニタリングAPIをコマンドライン・インタフェース(CLI)を使用してコールする必要があります。作成したOracle Cloud Infrastructureコンピュート・インスタンスでGrafanaを実行する場合、一致ルールを構成して、そのインスタンスを動的グループに追加できます。すべてのシナリオで、CLIを使用してAPIを呼び出すことができます。

Grafanaプラグイン(Oracle Cloud Infrastructure Data Source for Grafana)のインストールに関する手順は、https://github.com/oracle/oci-grafana-pluginを参照してください。

Grafanaプラグインの構成

この項では、Grafanaプラグインの追加方法およびダッシュボードの設定方法について説明します。

Grafanaプラグインを構成するには
ノート

ローカルにインストールされた場合、GrafanaプラグインはモニタリングAPIへのコールを使用してメトリックにアクセスします。

  1. Oracle Cloud Infrastructure APIにアクセスするためのCLIを設定します。

    認証のためにモニタリングAPIにアクセスする必要があります。

  2. 次のURLのGrafanaホームページにアクセスします。

    http://localhost:3000

  3. Grafanaプラグイン(Oracle Cloud Infrastructure Data Source for Grafana)を追加します。

    次のステップに加えて、https://grafana.com/docs/grafana/latest/getting-started/getting-started/で、データ・ソースを追加するためのGrafanaの手順を参照してください。

    1. Grafanaのホーム・ダッシュボードで、左側の歯車アイコンをクリックします。
    2. 「Add data source」をクリックします。
    3. 「Filter」テキスト・ボックスに入力します: oracle-oci-datasource
    4. フィルタリングされたリストで、「oracle-oci-datasource」を選択します。

    5. 「Settings」ページで、「Tenancy OCID」、「Default Region」および「Environment」に入力します。「Environment」で、「local」を選択します。

  4. タイプ「Graph」のダッシュボードを設定します。

  5. (オプション)Oracle Cloud Infrastructureのメトリックへのアクセスを確認するには、特定のリージョン、コンパートメント、ネームスペース、メトリックを使用してダッシュボード問合せ(「メトリック」)を更新します。1つ以上のディメンションを追加することもできます。

    これで終了です。GrafanaでOracle Cloud Infrastructureのメトリックを表示できるようになりました。

「Environment」オプション

localは、Oracle Cloud Infrastructureの外部にあるGrafanaデプロイメント用です。

OCIインスタンスは、Oracle Cloud Infrastructureリソース上のGrafanaデプロイメント用です。

これでデータ・ソースが追加され、Oracle Cloud Infrastructureのメトリックを示すダッシュボードを設定できるようになります。

プラグインのトラブルシューティング

ダッシュボード問合せ(「Metrics」)でオプションを移入できなかった場合、またはメトリックはアクセスに関して他の問題がある場合は、メトリックへのアクセスに使用されるIAMポリシーが正しくありませんか、動的グループ(作成したOracle Cloud Infrastructureコンピュート・インスタンスでGrafanaを実行する場合)で必要なすべての一致ルールが含まれていない可能性があります。

この問題を解決するには、次のようにします。

  • IAMポリシーを確認して、前提条件と一致することを確認してください。
  • IAMポリシーを更新した場合は、Grafanaサーバーを再起動し、Grafanaホームページをリフレッシュします。