次の方法で共有


Azure Managed Grafana に移行する

このガイドでは、Azure CLI を使用して、ローカルまたはクラウドで管理されている Grafana から Azure Managed Grafana にコンテンツを移行する方法について説明します。 次の要素は自動的に移行できます:

  • データ ソース
  • フォルダー
  • ライブラリ パネル
  • dashboards
  • スナップショット
  • 注釈

前提条件

  • Azure Cloud Shell で Bash 環境を使用します。 詳細については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。

  • CLI リファレンス コマンドをローカルで実行する場合、Azure CLI をインストールします。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。 詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。

    • ローカル インストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。 認証プロセスを完了するには、ターミナルに表示される手順に従います。 その他のサインイン オプションについては、Azure CLI でのサインインに関するページを参照してください。

    • 初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。 拡張機能の詳細については、Azure CLI で拡張機能を使用する方法に関するページを参照してください。

    • az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。 最新バージョンにアップグレードするには、az upgrade を実行します。

次の手順では、Azure プラットフォームを使用して Grafana インスタンスから Azure Managed Grafana にコンテンツを移行する方法を示します。

ヒント

最も簡単な方法は Azure CLI を使用して コンテンツを移行することです。ご検討ください。

Note

このチュートリアルで説明する手順の一部は、使用している Grafana のバージョンによって若干異なります。 このチュートリアルは、Grafana 10 を使用して作成されました。

前提条件

サービス アカウント トークンを作成する

まず、サービス アカウント トークンを作成して、Grafana インスタンスにアクセスしてコンテンツをエクスポートするために必要なアクセス許可を付与します。

  1. コンテンツを収集する Grafana (ソース)で、[管理]>[ユーザーとアクセス]>[サービス アカウント]>[サービス アカウントの追加] に移動して、管理者アクセス許可を持つ新しいサービス アカウントを作成します。

    [サービス アカウントの追加] アクションを示す Grafana UI のスクリーンショット。

    ヒント

    この手順では、Grafana サービス アカウントを使用する必要があります。 Azure Managed Grafana ワークスペースから移行する場合は、Azure Managed Grafana でサービス アカウントを有効にしてください

  2. 新しいサービス アカウントの表示名を入力し、[管理者] ロール、[適用]、および [作成] を選択します。

  3. サービス アカウントが作成されたら、 [トークンの追加] を選択し、必要に応じて有効期限を設定し、[トークンを生成する] を選択します。 このページを離れるとトークンを再び表示できなくなるので、この時点でトークンをコピーしてください。

Grafana 移行コマンドを実行する

Azure CLI で、az grafana migrate コマンドを実行します。 次のコマンドを実行するときは、プレースホルダー <target-grafana><target-grafana-resource-group><--src-endpoint><source-grafana-endpoint><source-token> を、移行先の Azure Managed Grafana ワークスペース (ターゲット) の名前とリソース グループ、コンテンツを収集する Grafana のエンドポイント (ソース)、前に作成したサービス アカウント トークンに置き換えます。

az grafana migrate --name <target-grafana> --resource-group <target-grafana-resource-group> --src-endpoint <source-grafana-endpoint> --src-token-or-key <source-token>

Azure CLI の出力には、Azure Managed Grafana ワークスペースに移行されたすべての要素が一覧表示されます。

このコマンドの省略可能なパラメーターは次のとおりです:

  • --dry-run: コミットせずに変更をプレビューします。
  • --folders-to-exclude: バックアップまたは同期で除外するフォルダー。
  • --folders-to-include: バックアップまたは同期に含めるフォルダー。
  • --overwrite: ターゲット Grafana ワークスペースに既に存在するダッシュボードを移行しようとすると、既定では、Azure Managed Grafana は、重複を作成しないように新しいデータ ソースの作成をスキップします。 上書きオプションを使用すると、以前のダッシュボード、ライブラリ パネル、およびフォルダーを同じ uid またはタイトルで上書きできます。

Grafana の移行を完了する

ターゲット ワークスペースに移動し、Grafana インスタンスから移行したすべてのものを見つけることができることを確認します。

重要

データ ソースがシークレットを使用して設定されている場合は、ターゲット ワークスペースでこれらのシークレットを手動で再構成して、データ ソースを正常に構成する必要があります。

Grafana ダッシュボードをエクスポートする

まず、Grafana ダッシュボードを JSON ファイルとしてエクスポートします。

  1. Grafana ユーザー インターフェイスを開き、[ダッシュボード] に移動します。

  2. いずれかのダッシュボードを開き、[パネルまたはダッシュボードを共有] アイコンを選択します。

  3. [エクスポート] タブに移動し、[ファイルに保存] 選択します。

    [JSON モデル] タブで JSON データが表示されている Grafana ユーザー インターフェイスのスクリーンショット。

  4. エクスポートしたいダッシュボードごとにこのプロセスを繰り返します。

Grafana ダッシュボードを Azure Managed Grafana にインポートする

エクスポートした JSON ファイルをインポートして、Azure Managed Grafana に新しいダッシュボードを作成します。

  1. Azure Managed Grafana ワークスペースの [概要] ページで、[エンドポイント] URL を開き、Grafana ポータルを開きます。

  2. ページの上部にある + を選択し、[ダッシュボードのインポート] を選択します。

    Azure Managed Grafana ワークスペースの Grafana UI のスクリーンショット。この画像は、ページの上部にある [+] ボタンと [ダッシュボードのインポート] ボタンを示しています。

  3. [ダッシュボード JSON ファイルのアップロード] を選択し、ローカル コンピューター上のファイルを選択します。

  4. [読み込む] を選択し、ダッシュボードの設定を確認します。 必要に応じて、ダッシュボード名、フォルダー、および一意識別子 (UID) を編集します。

  5. [インポート] を選択してダッシュボードを保存します。 インポートしたいダッシュボードごとに、このプロセスを繰り返します。

    Azure Managed Grafana ワークスペースの Grafana UI のスクリーンショット。この画像はインポート オプションを示しています。

ダッシュボードを作成および編集する方法の詳細については、「Azure Managed Grafana でダッシュボードを作成する」を参照してください。

データ ソース プラグインをインストールする

ワークスペースの価格プランでサポートされているコア データ ソース プラグインは、既定でインストールされます。 他のオプションのプラグインをインストールするには、次のプロセスに従います:

  1. Azure portal でワークスペースを開き、[Plugin 管理 (プレビュー)] に移動します。
  2. インストールするプラグインのチェックボックスをオンにして、[保存] を選択します。
  3. インストールしたいデータ ソース プラグインごとに、このプロセスを繰り返します。

詳細については、「プラグインの追加」を参照してください。

データ ソースを構成する

Azure Managed Grafana で新しいデータ ソースを構成します。

  1. Azure Managed Grafana ワークスペースの [概要] ページで、[エンドポイント] URL を開き、Grafana ポータルを開きます。
  2. Grafana ユーザー インターフェイスで、[接続]>[データ ソース]>[新しいデータ ソースの追加]に移動します。
  3. データ ソースを一覧から選択します。
  4. 必要なフィールドに入力し、[保存してテスト] を選択して構成を保存し、Grafana がデータ ソースに接続できることを確認します。
  5. データ ソースごとにこのプロセスを繰り返します。

プラグイン、データ ソース、ダッシュボードの詳細については、次のコンテンツを確認してください: