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

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

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

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

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

当社の企業価値である「平等」に合致させるため、包括的ではない用語を可能な限り変更しました。場面に応じて用語を変更すると重大な影響につながる可能性があるため、既存の用語を維持します。そのため、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 ノードで Resource Monitoring Tool エージェント サービスを停止します。

      rmtadmin stop --agent

    3. 次のコマンドを実行して、すべてのエージェントをアップグレードします。

      CentOS を含む、RHEL のようなディストリビューションの場合:

      sudo yum install <pathtoagentinstaller>/<tabrmt-agent-setup-<version>-x86_64.rpm>

      sudo /opt/tableau/tabrmt/agent/install-scripts/upgrade-rmt-agent --accepteula

      Ubuntu ディストリビューションや Debian ディストリビューションの場合:

      バージョン 2020.4 から 2020.4.1 以降にアップグレードする場合は、次の手順を実行します。

      touch /tmp/tabrmt-agent-upgrading.txt && sudo apt install <tabrmt-agent-setup-<version>-amd_64.deb>

      sudo /opt/tableau/tabrmt/agent/install-scripts/upgrade-rmt-agent --accepteula

      注: touch コマンドは、2020.4 からアップグレードする場合にのみ必要です。パッケージをインストールする前に touch コマンドを実行しない場合は、アップグレードの前に既存のバージョンの Resource Monitoring Tool をアンインストールします。

      バージョン 2020.4.1 から 2020.4.2 以降にアップグレードする場合は、次の手順を実行します。

      sudo apt install <pathtoagentinstaller>/<tabrmt-agent-setup-<version>-amd_64.deb>

      sudo /opt/tableau/tabrmt/agent/install-scripts/upgrade-rmt-agent --accepteula

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

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

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

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

    1. RMT サーバーがインストールされているマシンに RMT サーバー パッケージの新しいバージョンをコピーします。
    2. 次のコマンドを使用して、RMT サーバーで Resource Monitoring Tool を停止します。

      rmtadmin stop --master

    3. 次のコマンドを使用して、Tableau Server のすべてのノードで Resource Monitoring Tool を停止します。

      rmtadmin stop --agent

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

      rmtadmin status

    5. RMT サーバーでコマンドのアップグレードを実行します。これにより、既存のバージョンが新しいバージョンにアップグレードされます。

      CentOS を含む、RHEL のようなディストリビューションの場合:

      sudo yum install <pathtomasterserverinstaller>/<tabrmt-master-setup-<version>-x86_64.rpm>

      sudo /opt/tableau/tabrmt/master/install-scripts/upgrade-rmt-master --accepteula

      Ubuntu ディストリビューションや Debian ディストリビューションの場合:

      バージョン 2020.4 から 2020.4.1 以降にアップグレードする場合は、次の手順を実行します。

      touch /tmp/tabrmt-master-upgrading.txt && sudo apt install <tabrmt-master-setup-<version>-amd_64.deb>

      sudo /opt/tableau/tabrmt/master/install-scripts/upgrade-rmt-master --accepteula

      注: touch コマンドは、2020.4 からアップグレードする場合にのみ必要です。パッケージをインストールする前に touch コマンドを実行しない場合は、アップグレードの前に既存のバージョンの Resource Monitoring Tool をアンインストールします。

      バージョン 2020.4.1 から 2020.4.2 以降にアップグレードする場合は、次の手順を実行します。

      sudo apt install <pathtomasterserverinstaller>/<tabrmt-master-setup-<version>-amd_64.deb>

      sudo /opt/tableau/tabrmt/master/install-scripts/upgrade-rmt-master --accepteula

    6. エージェントと 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 ユーザー。