エージェント インシデント

エージェントのライセンスなし (重要)

互換性のないエージェント バージョン (重要)

エージェント メッセージ キューの認証資格情報ローテーションの失敗 (重大)

エージェント ダウン (警告)

当社の企業価値である「平等」に合致させるため、包括的ではない用語を可能な限り変更しました。場面に応じて用語を変更すると重大な影響につながる可能性があるため、既存の用語を維持します。そのため、CLI コマンドとオプション、インストール フォルダー、構成ファイル、その他のインスタンスには、これらの用語が引き続き使用されます。詳細については、「Tableau ヘルプについて」(新しいウィンドウでリンクが開く)を参照してください。

エージェントのライセンスなし

エージェントのライセンスなしのインシデントは、Tableau Server が Tableau Resource Monitoring Tool を使用するよう適切にライセンスされていないことを検出する場合に重要としてログに記録されます。

Resource Monitoring Tool を使用する Tableau Server を監視するには、Tableau Server で Tableau Advanced Management がライセンスされている必要があります。

エージェントはライセンスなしの状態ではデータを収集して RMT サーバーに送信することはなくなります。ただし、環境が適切にライセンスされている場合には、以前収集したデータを引き続き表示できます。

この問題を解決するには、Advanced Management を使用して Tableau Server にライセンスを付与します。詳細については、「Tableau Server 上の Tableau Advanced Management について」を参照してください。

注: インシデントをクリアするには、Tableau Server に有効なライセンスを追加してから最大 1 時間かかる場合があります。

Agents Unlicensed インシデントの原因としては、他にも考えられる原因があります。

  • Tableau Server API の認証資格情報が正しくない可能性があります。環境構成ページで、ユーザー名とパスワードが正しいこと、および使用するアカウントに Tableau Server のサーバー管理者ロールがあることを確認します。

  • Tableau Server REST API に接続できません。Tableau Server で REST API が有効にされていること、および Tableau Server が実行されていることを確認します。

    REST API 接続の問題を解決するには、 Admin メニューで Environments を選択し、変更する環境で Edit Environment をクリックし、Environment Details タブで、ページの右側の Tableau Server REST API セクションでTest Connection ボタンをクリックします。

  • RMT サーバーは、ネットワーク接続または類似の問題が原因で、Tableau Server に接続できませんでした。

互換性のないエージェント バージョン

環境内の 1 つ以上のエージェントが RMT サーバーのバージョンと互換性のないバージョンを使用している場合、互換性のないエージェントは「重要」なインシデントとしてログに記録されます。

この問題を解決するには、エージェントが現在の RMT サーバーのバージョンと互換性のあるバージョンであることを確認する必要があります。

この問題を解決するには、次のいずれかの手順を実行します。

  • RMT サーバーとすべてのエージェントを同じバージョンにすることをお勧めします。
    • エージェントが互換性のある最小バージョンよりも前のバージョンを使用している場合は、インシデント レポートに記載されている互換性のある最小バージョンにエージェントをアップグレードする必要があります。
    • エージェントが RMT サーバーのバージョンよりも新しいバージョンを使用している場合は、RMT サーバーも同じ新しいバージョンにアップグレードすることをお勧めします。現在使用しているバージョンによっては、他のエージェントをアップグレードする必要がある場合があります。

    エージェントのアップグレード:

    エージェントをアップグレードするには、以下のステップを行います。

    1. エージェント セットアップ プログラムをダウンロードし、それをエージェントをアップグレードする必要がある Tableau Serverノードにコピーします。エージェントは、RMT サーバーと同じバージョンであるか、RMT サーバーのバージョンと互換性のあるバージョンを使用する必要があります。インシデントの詳細には、互換性のある最小バージョンが記載されています。
    2. 次のコマンドを使用して、すべての Tableau Server ノードで Tableau Resource Monitoring Tool エージェント サービスを停止します。

      rmtadmin stop --agent

    3. アップグレードが必要なエージェントでエージェント セットアップ プログラムを実行します。

      注: 既定以外の場所を使用している場合は、EULA ページで [Customize] をクリックして、カスタム インストールの場所を指定します。Tableau では、エージェントをインストールする場所として、\Tableau\Tableau Resource Monitoring Tool を使用することが推奨されています。既定以外の場所の例: D:\Tableau\Tableau Resource Monitoring Tool

    4. エージェントが実行中であり、アップグレードされていることを確認します。[管理] > [環境] > [環境の編集] > [サーバー] タブに移動すると、エージェントの登録ステータスを表示して、Tableau Server ノードの完全なリストとエージェントのステータスを確認できます。

    RMT サーバーのアップグレード

    1 つ以上のエージェントが新しいバージョンである場合は、RMT サーバーをアップグレードします。

    RMT サーバーをアップグレードするには、以下のステップを実行します。

    1. アップグレードを開始する前に、ブラウザーで Resource Monitoring Tool にログインし、動作していることを確認します。

    2. RMT サーバーがインストールされているマシンに RMT サーバー セットアップ プログラムをコピーします。

    3. すべてのエージェント でTableau Resource Monitoring Tool エージェント Windows サービスを停止します。
    4. RMT サーバーで Tableau Resource Monitoring Tool Windows サービスを停止します。

      注: サービスが停止されたら、tabrmt-agent や tabrmt-master のいずれかを使用してサービスの停止後に実行されている Resource Monitoring Tool プロセスを確認することがベスト プラクティスです。これには、PostgreSQL や RabbitMQ は含まれません。

    5. RMT サーバーで実行されているすべてのプロセスを完全に停止するには時間がかかるため、タスク マネージャーでは、名前に Resource Monitoring Tool が含まれる実行中のプロセスがなくなるのを待ってから次のステップに進みます。
    6. RMT サーバーでセットアップ プログラムを実行します。これにより、必要な前提条件のインストールやアップグレードを実行し、RMT サーバーをアップグレードします。

      注: 既定以外の場所を使用している場合は、EULA ページで [Customize] をクリックして、カスタム インストールの場所を指定します。Tableau では、RMT サーバーをインストールする場所として、\Tableau\Tableau Resource Monitoring Tool を使用することをお勧めします。既定以外の場所の例: D:\Tableau\Tableau Resource Monitoring Tool

    7. エージェントと RMT サーバーが実行中であることを確認します。アップグレードの完了後にエージェントと RMT サーバーが自動的に再起動しない場合は、エージェントと RMT サーバーを起動します。

    エージェント メッセージ キューの認証資格情報ローテーションの失敗

    バージョン 2021.3 以降、セキュリティのベスト プラクティスとして、エージェントと Rabbit MQ 間の接続の認証資格情報はそのエージェントに固有のものにする必要があります。一意の認証資格情報は、新規インストール時に作成されるか、2021.3 へのアップグレード時に更新されます。

    アップグレード中にネットワークに問題が発生すると、認証資格情報の更新プロセスが失敗し、重大なインシデント レポートが作成される可能性があります。ただし、これによってアップグレード プロセスが中断されることはなく、プロセスは続行されます。アップグレードが完了すると、Resource Monitoring Tool は、一意の認証資格情報の作成を毎日再試行します。重大なインシデント レポートは、最初の失敗と後続の再試行の失敗に対して作成されます。その間、エージェントは、新しい認証資格情報が作成されるまで、以前の認証資格情報を使用して作業を続けます。

    この問題は自動的に解決する可能性がありますが、問題が解決しない場合は、次の手順を実行してください。

    • エージェントが RMT サーバーに接続できることを確認します。
    • エージェントと RMT サーバー間のファイアウォールの問題を確認します。

    エージェント ダウン

    エージェント ダウン インシデントは、 Tableau Resource Monitoring Toolが Tableau Server 上のエージェントと通信できない場合に警告としてログに記録されます。

    この問題を解決するには、次のステップを行います。

    1. エージェントをホストするハードウェアが実行されており、RMT サーバーと通信できることを確認します。
    2. エージェント サービスが正常に登録され、実行されていることを確認します。[管理] > [環境] > [環境の編集] > [サーバー] タブに移動すると、エージェントの登録ステータスを表示して、Tableau Server ノードの完全なリストとエージェントのステータスを確認できます。

    エージェントのポーリングとインシデントの作成時間

    • エージェントはハートビート メッセージを 5 分ごとにResource Monitoring Toolサーバーに送信します。
    • Resource Monitoring Tool サーバーは、エージェントから最新のハートビート メッセージを受信してから 15 分以上経過していないかどうかを確認します。
      • エージェントから最新のハートビート メッセージを受信してから 15分以上経過していない場合、そのエージェントはオンラインであると見なされ、インシデントは作成されず、既存のエージェントのダウン インシデントはすべてクリアされます。
      • エージェントから最新のハートビート メッセージを受信してから 15 分以上経過している場合、それは最初の試行が失敗したとみなされます。その後、1 分毎にさらに 2 回チェックが行われます。3 回の試行 (最初の試行と 2 回の再試行) を行った後も最新のハートビート メッセージを受信していない場合は、エージェントのダウン インシデントが作成されます。

      注: 上記のポーリング間隔に基づき、エージェントがオフラインになった後、エージェントのダウン インシデントが作成されるまでに約 17 (15 + 1 + 1) 分かかります。

    実行可能なユーザー

    "Server/Environment Management (サーバー/環境管理)" の役割を持つ Resource Monitoring Tool 管理者や Resource Monitoring Tool ユーザー。

    フィードバックをお送りいただき、ありがとうございます。フィードバックは正常に送信されました。ありがとうございます!