概要

このチェックは、Datadog Agent を通じて TIBCO Enterprise Message Service を監視します。

セットアップ

ホストで実行されている Agent 用にこのチェックをインストールおよび構成する場合は、以下の手順に従ってください。コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照してこの手順を行ってください。

インストール

TIBCO EMS チェックは Datadog Agent パッケージに含まれています。サーバー上での追加のインストールは不要です。

構成

1. Agent の構成ディレクトリのルートにある conf.d/ フォルダー内の tibco_ems.d/conf.yaml ファイルを編集して、TIBCO EMS のパフォーマンス データの収集を開始します。利用可能な構成オプションはすべて、サンプル tibco_ems.d/conf.yaml を参照してください。

2. Agent を再起動します。

メトリクスの収集

Tibco EMS コマンド スクリプトを作成する

Tibco EMS インテグレーションは、Tibco EMS が提供する tibemsadmin CLI ツールを利用します。$sys.admin キューへの呼び出し回数を減らすために、Datadog は Tibco へのクエリをバッチ化するスクリプトを使用します。Tibco EMS のメトリクスを収集するには、スクリプトのパスと tibemsadmin バイナリの絶対パスをインテグレーションの構成に渡します。

注: dd-agent ユーザーには tibemsadmin バイナリの実行権限が必要です。

1. 次の内容で show_commands という名前のファイルを作成します:

    show connections full
    show durables
    show queues
    show server
    show stat consumers
    show stat producers
    show topics

2. tibco_ems.d/conf.yaml ファイルに次の構成ブロックを追加して、Tibco EMS メトリクス の収集を開始します:

init_config:
instances:
    ## @param script_path - 文字列 - 任意
    ## メトリクスを収集するために実行されるスクリプトへのパス。スクリプトはサブ プロセスによって実行されるため、
    ## スクリプトへのパスを指定する必要があります。これはスクリプトへの絶対パスでなければなりません。
    #
    script_path: <SCRIPT_PATH>

    ## @param tibemsadmin - 文字列 - 任意
    ## tibemsadmin のコマンドまたはパス (例: /usr/bin/tibemsadmin または docker exec <container> tibemsadmin)
    ## は、インスタンスで上書きできます。
    ##
    ## これは `init_config` で定義された `tibemsadmin` を上書きします。
    #
    tibemsadmin: <TIBEMSADMIN>

3. Datadog への Tibco EMS メトリクスの送信を開始するには、Agent を再起動 します。

ログ収集

Agent バージョン 6.0 以降で利用可能

1. Datadog Agent では、ログの収集はデフォルトで無効になっています。datadog.yaml ファイルでログを有効にします:

   logs_enabled: true
   

2. Tibco EMS のログ収集を開始するには、次の構成ブロックを tibco_ems.d/conf.yaml ファイルに追加します:

   logs:
     - type: file
       path: <PATH_TO_LOG_FILE>
       service: <MY_SERVICE>
       source: tibco_ems
   

   service と path のパラメーター値を変更し、環境に合わせて設定してください。利用可能な構成オプションのすべてについては サンプル tibco_ems.yaml を参照してください。

3. Agent を再起動します。

検証

Agent の status サブ コマンドを実行 し、Checks セクションの tibco_ems を確認します。

収集データ

メトリクス

イベント

TIBCO EMS インテグレーションにはイベントは含まれていません。

サービスチェック

TIBCO EMS インテグレーションにはサービス チェックは含まれていません。

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問い合わせください。