IBM ACE

Supported OS Linux Windows Mac OS

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

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [email protected].

概要

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

セットアップ

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

IBM MQ

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

Linux では、続行する前に、IBM MQ セットアップ に記載のとおり LD_LIBRARY_PATH 環境変数を設定してください。

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. 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 のサポートチームまでお問合せください。