概要

このチェックは、Datadog Agent を通じて IBM ACE を監視します。

セットアップ

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

IBM MQ

IBM ACE からメトリクスメッセージを消費するためには、IBM MQ サーバーが必要です。

IBM ACE

1. バージョン 12.0.2.0 以上がインストールされていることを確認します。
2. 以下のような <MQ_POLICY_NAME>.policyxml という形式の MQEndpoint ポリシーファイルを適用します。

   <?xml version="1.0" encoding="UTF-8"?>
   <policies>
       <policy policyType="MQEndpoint" policyName="<MQ_POLICY_NAME>" policyTemplate="MQEndpoint">
           <connection>CLIENT</connection>
           <destinationQueueManagerName>...</destinationQueueManagerName>
           <queueManagerHostname>...</queueManagerHostname>
           <listenerPortNumber>1414</listenerPortNumber>
           <channelName>...</channelName>
           <securityIdentity><MQ_SECURITY_IDENTITY></securityIdentity>
       </policy>
   </policies>
   

3. mqsisetdbparms -n mq::<MQ_SECURITY_IDENTITY> -u <user> -p <password> を実行して、資格情報を設定します。
4. server.conf.yaml ファイルを以下の構成で更新します。

   remoteDefaultQueueManager: '{DefaultPolicies}:<MQ_POLICY_NAME>'
   Events:
     OperationalEvents:
       MQ:
         enabled: true
     BusinessEvents:
       MQ:
         enabled: true
         outputFormat: json
   Statistics:
     Resource:
       reportingOn: true
     Snapshot:
       publicationOn: active
       outputFormat: json
       accountingOrigin: basic
       nodeDataLevel: advanced
       threadDataLevel: basic
   Monitoring:
     MessageFlow:
       publicationOn: active
       eventFormat: MonitoringEventV2
   AdminLog:
     enabled: true
     fileLog: true
     consoleLog: true
     consoleLogFormat: ibmjson
   

5. IBM ACE を再起動します。

インストール

IBM ACE チェックは Datadog Agent パッケージに含まれています。 サーバーに追加でインストールする必要はありません。

構成

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

2. Agent を再起動します。

検証

Agent の status サブコマンドを実行し、Checks セクションで ibm_ace を探します。

収集データ

メトリクス

イベント

IBM ACE インテグレーションには、イベントは含まれません。

サービスのチェック

ibm_ace.mq.subscription
Returns CRITICAL if the subscription encounters an error, WARNING if no messages are available, or OK otherwise.
Statuses: ok, warning, critical

ログの収集

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

   logs_enabled: true
   

2. IBM ACE のログの収集を開始するには、次のコンフィギュレーションブロックを ibm_ace.d/conf.yaml ファイルに追加します。

   logs:
     - type: file
       path: /home/aceuser/ace-server/log/integration_server.txt
       source: ibm_ace
   

   path パラメーターの値を環境に合わせて変更します。使用可能なすべてのコンフィギュレーションオプションについては、ibm_ace.d/conf.yaml ファイルのサンプルを参照してください。

トラブルシューティング

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