サーバー イベント通知の構成

Tableau サービス マネージャー (TSM) 管理者は、次のイベントの通知を許可するように Tableau Server を構成できます。

  • コンテンツの更新
    • 抽出失敗 (既定では有効)
    • ユーザーのサブスクリプション ビュー (既定では無効)
  • サーバーの健全性モニタリング
    • サーバー ステータスの変化 (既定では無効)
    • デスクトップ ライセンス レポート (既定では無効)
  • ドライブの空き容量
    • ディスク空き容量が事前に設定したしきい値以下になった場合に送信するメール アラート (デフォルトでは無効)
    • 使用履歴の記録 (既定では有効)

注: サブスクリプションまたは通知を設定する前に、SMTP を設定する必要があります。詳細については、SMTP セットアップの構成を参照してください。

  1. ブラウザーで TSM を開きます。

    https://<tsm-computer-name>:8850

    詳細については、「Tableau サービス マネージャーの Web UI へのサインイン」を参照してください。

  2. [構成] タブで [通知] をクリックし、[イベント] をクリックします。

  3. 組織に合わせた通知設定を構成します。

    • コンテンツの更新
      • 抽出更新の失敗の際にメールを送信する

        このオプションが有効 (既定) の場合、サーバー管理者は、抽出更新の失敗の際にメール通知を送信するように構成できます。これらのメッセージはサイト レベルで構成されるため、このオプションが有効になっていても、サイトで [スケジュールされた更新に失敗した場合、データ ソースおよびワークブックの所有者にメールを送信する] オプションが有効になっていない限り (既定では有効)、メッセージは送信されません。 詳細については、抽出更新スケジュールと失敗通知を有効にするを参照してください。

      • ユーザーに登録しているビューに関するメール受信を許可

        このオプションが有効になっている場合 (既定では無効)、サーバー管理者はサブスクリプション メールを送信するようにサイトを構成できます。これらのメール メッセージはサイト レベルで構成され、このオプションが有効な場合にのみ構成できます。詳細については、サブスクリプションのサーバー設定を参照してください。

        ユーザーがワークブックやビューをサブスクライブすると、ビューのスナップショットがそのユーザーにメールで送信されるため、ユーザーは Tableau Server にサインインせずに最新の更新を確認できます。

        ユーザーがサブスクリプション メールに PDF レンダリングを添付できるようにするには、[サブスクライブ中のビューへの添付ファイルの追加をユーザーに許可する] を選択します。

    • サーバーの健全性モニタリング
      • Tableau Server プロセス イベント (実行中、ダウン、フェールオーバー) に関するメールを送信する

        データ エンジン、ファイル ストア、ゲートウェイ、またはリポジトリ サーバー プロセスが停止または再開するとき、または最初の Tableau Server ノードが停止または再開するときに、Tableau Server がメール メッセージを送信します。

        単一サーバーへのインストールを実行している場合 (同じコンピューター上にすべてのプロセスが存在する場合)、健全性に関するアラートは、Tableau Server の稼働中にのみ送信されます。「DOWN (ダウン)」アラートは送信されません。フェールオーバーのために構成された分散インストールを実行している場合、DOWN (ダウン) アラートはアクティブなリポジトリまたはデータ エンジンのインスタンスに障害が発生していることを意味し、後続の UP (アップ) アラートはプロセスのパッシブ インスタンス (リポジトリ) または 2 番目のインスタンス (データ エンジン) が引き継いだことを意味します。

        注: Tableau Server は、自己修正するように設計されています。サービスまたはプロセスが応答を停止するかダウンした場合、Tableau Server はそれを再起動しようとします。これを完了するまでに 15 〜 30 分かかる場合があります。そのため、サービスまたはプロセスのアラートにすぐに対応しても、特に再起動中に要求を処理できる冗長サービスを備えたインストールでは、非生産的なアクションになる可能性があります。

      • Tableau Desktop ライセンス レポートの有効化

        ライセンス レポートは Tableau Desktop で生成され、Tableau Server に送信されます。このオプションが有効になっている場合、Tableau Server はデスクトップ ライセンス レポートの管理レポートを生成して表示します。レポートの詳細については、デスクトップ ライセンスの使用率を参照してください。

      • ドライブの空き容量

        Tableau Server のディスク空き容量についての通知 (アラート) を有効にします。

        • 未使用のドライブ空き容量がしきい値を下回っている場合にメールを送信する

          いずれかのノードでディスク空き容量がしきい値を下回った場合や、継続して下回っている場合にメール 通知を送信するように、Tableau Server を設定できます。しきい値の通知を送信する頻度も設定できます。

          [警告しきい値][重要しきい値] の 2 つを設定する必要があります。しきい値は、残っているディスク空き容量のパーセンテージで表されます。クリティカルしきい値は、警告しきい値よりも小さくなければなりません。

          [Send threshold alert every (しきい値アラートを送信する頻度)] オプションも指定します。これにより、警告や緊急の通知を送信する間隔 (分) を決定します。既定値は 60 分です。

        • カスタム管理ビュー用のディスク空き容量の使用率に関する情報としきい値違反を記録する

          ディスク空き容量の使用率を記録するよう Tableau Server を設定している場合、ディスク空き容量に関する情報はリポジトリに保存され、管理ビューを使用して使用履歴を表示できます。

  4. 構成情報を入力したら、[保留中の変更を保存] をクリックします。

  5. ページ上部の [変更を保留中] をクリックします。

  6. [変更を適用して再起動] をクリックします。

tsm configuration set コマンドを使用し、前述のさまざまな通知の値を個別に設定できます。または、json ファイルを作成し、1 回の操作ですべての構成値を渡すこともできます。どちらの方法も本セクションで説明しています。

個別に通知の値を設定する

以下の表は、本トピックで前述した通知イベントにマッピングするキー/値のペアを示しています。単一のキー/値のペアを設定するには、以下の構文で tsm configuration set コマンドを使用します。

tsm configuration set -k <config.key> -v <config_value>

たとえば、ジョブ失敗の通知を有効にするには、以下のコマンドを実行します。

tsm configuration set -k backgrounder.notifications_enabled -v true

通知オプションキー
抽出失敗またはフロー実行失敗backgrounder.notifications_enabledtrue | false
ユーザーのサブスクリプション ビューの有効化subscriptions.enabledtrue | false
サブスクリプションの PDF 添付ファイルの有効化subscriptions.attachments_enabledtrue | false
サブスクリプション通知の最大添付ファイル サイズ (MB)subscriptions.max_attachment_size_megabytes整数値。既定は 150 です
サーバー ステータスの変化svcmonitor.notification.smtp.enabledtrue | false
ライセンスのレポートfeatures.DesktopReportingtrue | false
残っている容量のしきい値: メール通知の有効化storage.monitoring.email_enabledtrue | false
残っている容量のしきい値: 警告を行うパーセンテージstorage.monitoring.warning_percent20 などの整数値
残っている容量のしきい値: クリティカルなパーセンテージstorage.monitoring.critical_percent15 などの整数値
メール間隔の設定storage.monitoring.email_interval_min25 などの整数値 (分)
使用履歴の記録storage.monitoring.record_history_enabledtrue | false

値を設定したら、以下のコマンドを実行する必要があります。

tsm pending-changes apply

保留中の変更にサーバーの再起動が必要な場合は、pending-changes apply コマンドの実行時に、再起動が行われることを知らせるメッセージが表示されます。このメッセージはサーバーが停止していても表示されますが、その場合には再起動は行われません。--ignore-prompt オプションを使用してメッセージが表示されないようにできますが、そのようにしても再起動に関する動作が変わることはありません。変更に再起動が必要ない場合は、メッセージなしで変更が適用されます。詳細については、tsm pending-changes applyを参照してください。

単一の json ファイルを使用してすべての通知の値を設定する

単一の構成ですべての通知設定を作成するには、json ファイルを渡します。

次のテンプレートをコピーして編集し、構成用のファイルを作成します。

{
  "configKeys": {
    "backgrounder.notifications_enabled": true,
    "subscriptions.enabled": true,
    "subscriptions.attachments_enabled": true,
    "subscriptions.max_attachment_size_megabytes": 150,
    "svcmonitor.notification.smtp.enabled": true,
    "features.DesktopReporting": true,
    "storage.monitoring.email_enabled": true,
    "storage.monitoring.warning_percent": 20,
    "storage.monitoring.critical_percent": 15,
    "storage.monitoring.email_interval_min": 25,
    "storage.monitoring.record_history_enabled": true
  }
}

ファイルを保存したら、それを以下のコマンドを使用して渡します。

tsm settings import -f <path-to-file.json>

変更を適用するには、次のコマンドを実行します。

tsm pending-changes apply

保留中の変更にサーバーの再起動が必要な場合は、pending-changes apply コマンドの実行時に、再起動が行われることを知らせるメッセージが表示されます。このメッセージはサーバーが停止していても表示されますが、その場合には再起動は行われません。--ignore-prompt オプションを使用してメッセージが表示されないようにできますが、そのようにしても再起動に関する動作が変わることはありません。変更に再起動が必要ない場合は、メッセージなしで変更が適用されます。詳細については、tsm pending-changes applyを参照してください。

 

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