概要
このチェックは、Datadog Agent を通じて IBM ACE を監視します。
セットアップ
ホストで実行されている Agent 用にこのチェックをインストールおよび構成する場合は、以下の手順に従ってください。コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照してこの手順を行ってください。
IBM MQ
IBM ACE からメトリクスメッセージを消費するためには、IBM MQ サーバーが必要です。
Linux では、続行する前に、
IBM MQ セットアップ に記載のとおり LD_LIBRARY_PATH 環境変数を設定してください。
IBM ACE
- バージョン 12.0.2.0 以上がインストールされていることを確認します。
- 以下のような
<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>
mqsisetdbparms -n mq::<MQ_SECURITY_IDENTITY> -u <user> -p <password> を実行して、資格情報を設定します。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
- IBM ACE を再起動します。
インストール
IBM ACE チェックは Datadog Agent パッケージに含まれています。
サーバーに追加でインストールする必要はありません。
構成
ibm_ace のパフォーマンスデータの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの ibm_ace.d/conf.yaml ファイルを編集します。使用可能なすべてのコンフィギュレーションオプションについては、サンプル ibm_ace.d/conf.yaml を参照してください。
Agent を再起動します。
検証
Agent の status サブコマンドを実行し、Checks セクションで ibm_ace を探します。
収集データ
メトリクス
イベント
IBM ACE インテグレーションには、イベントは含まれません。
サービスチェック
ログ収集
Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml ファイルでこれを有効にします。
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 のサポートチームまでお問合せください。