Azure Managed Grafana でサービス アカウントを使用する方法

  • [アーティクル]

このガイドでは、サービス アカウントを使う方法について説明します。 サービス アカウントは、自動化された操作を実行する場合、Grafana API を使って Grafana でアプリケーションを認証する場合に使われます。

一般的な使用用途は次のとおりです。

  • ダッシュボードをプロビジョニングまたは構成する
  • レポートをスケジュールする
  • アラートを定義する
  • 外部 SAML 認証プロバイダーを設定する
  • ユーザーとしてサインインせずに Grafana と対話する

前提条件

サービス アカウントを有効にする

既存の Grafana ワークスペースでサービス アカウントが有効になっていない場合は、Grafana インスタンスの基本設定を更新してサービス アカウントを有効にすることができます。

  1. Azure portal の [設定] で [構成] を選び、次に [API keys and service accounts] (API キーとサービス アカウント) で [有効にする] を選びます。

    Azure プラットフォームのスクリーンショット。サービス アカウントを有効にする。

  2. [保存] を選び、Azure Managed Grafana で API キーとサービス アカウントを有効にすることを確定します。

サービス アカウントの作成

以下の手順に従って新しい Grafana サービス アカウントを作成し、既存のサービス アカウントを一覧表示します。

  1. Grafana インスタンスのエンドポイントに移動し、[構成] で [サービス アカウント] を選びます。

  2. [サービス アカウントを追加] を選び、新しい Grafana サービス アカウントの [表示名] と [ロール] ([閲覧者]、[編集者]、または [管理者]) を入力し、[作成] を選びます。

    Grafana のスクリーンショット。[サービス アカウントの追加] ページ。

  3. このページには、"Service account successfully created" (サービス アカウントが正常に作成されました) という通知と、新しいサービス アカウントに関する情報が表示されます。

  4. 戻る矢印記号を選ぶと、Grafana インスタンスのすべてのサービス アカウントの一覧が表示されます。

サービス アカウント トークンを追加してトークンを確認する

サービス アカウントを作成したら、1 つ以上のアクセス トークンを追加します。 アクセス トークンは、Grafana API に対する認証に使われる生成された文字列です。

  1. サービス アカウント トークンを作成するには、[トークンの追加] を選びます。

  2. 自動的に生成された [表示名] を使うか、任意の名前を入力し、必要に応じて [有効期限] を選ぶか、有効期限を設定しない既定のオプションをそのまま使います。

    Azure プラットフォームのスクリーンショット。[サービス アカウント トークンの追加] ページ。

  3. [トークンの生成] を選び、生成されたトークンをメモします。 このトークンは 1 回だけ表示されます。トークンを失うと新規作成する必要があるため、必ず保存してください。

  4. サービス アカウントを選ぶと、関連付けられたすべてのトークンの一覧など、サービス アカウントに関する情報にアクセスできます。

サービス アカウントを編集する

このセクションでは、次の方法で Grafana サービス アカウントを更新する方法について説明します。

  • サービス アカウントの名前を編集する
  • サービス アカウントのロールを編集する
  • サービス アカウントを無効にする
  • サービス アカウントを有効にする

アクション:

  • 名前を編集するには、サービス アカウントを選び、[情報] で [編集] を選びます。
  • ロールを編集するには、サービス アカウントを選び、[情報] でロールを選び、別のロール名を選びます。
  • サービス アカウントを無効にするには、サービス アカウントを選び、ページの上部にある [サービス アカウントを無効にする] を選んでから [サービス アカウントを無効にする] を選んで確定します。 無効になったサービス アカウントは、[サービス アカウントを有効にする] を選んで再び有効にすることができます。

Azure プラットフォームのスクリーンショット。[サービス アカウントの編集] ページ。

"Service account updated" (サービス アカウントが更新されました) という通知がすぐに表示されます。

サービス アカウントを削除する

Grafana サービス アカウントを削除にするには、サービス アカウントを選び、ページの上部にある [サービス アカウントの削除] を選んでから [サービス アカウントの削除] を選んで確定します。 サービス アカウントの削除は最終的なものであり、削除後にサービス アカウントを復旧することはできません。

Azure プラットフォームのスクリーンショット。[サービス アカウントの削除] ページ。

サービス アカウント トークンを削除する

サービス アカウント トークンを削除するには、サービス アカウントを選び、[トークン] で [削除 (x)] を選びます。 [削除] を選択して確定します。

Azure プラットフォームのスクリーンショット。[サービス アカウント トークンの削除] ページ。

次のステップ

この攻略ガイドでは、Azure Managed Grafana で自動操作を実行するためのサービス アカウントとトークンの作成および管理方法を学習しました。 準備ができたら、その他の記事を参照してください。

ゾーン冗長性を有効にする