IBM ACE

Supported OS Linux Windows Mac OS

インテグレーションバージョン2.2.2

概要

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

セットアップ

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

IBM MQ

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

For Linux, make sure to set the LD_LIBRARY_PATH environment variable as described in the IBM MQ setup before continuing.

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 インテグレーションには、イベントは含まれません。

サービスチェック

ログ収集

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

    logs_enabled: true

  2. To start collecting your IBM ACE logs, add this configuration block to your ibm_ace.d/conf.yaml file:

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

    Change the path parameter value based on your environment. See the sample ibm_ace.d/conf.yaml file for all available configuration options.

トラブルシューティング

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

PREVIEWING: may/embedded-workflows