HAProxy 🔗

The Splunk Distribution of the OpenTelemetry Collector uses the Smart Agent receiver with the HAProxy monitor type to monitor an HAProxy instance. This monitor requires HAProxy 1.5+.

注釈

To monitor your HAProxy instances you can instead use the native OpenTelemetry HAProxy receiver. To learn more, see HAProxy receiver.

メリット 🔗

インテグレーションを設定すると、これらの機能にアクセスできるようになります：

メトリクスを表示します。独自のカスタム・ダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードについては、Splunk Observability Cloudでダッシュボードを表示するを参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他のリソースのデータ駆動型の視覚化を表示します。ナビゲーターについては、Splunk Infrastructure Monitoring でナビゲーターを使用するを参照してください。
Metric Finder にアクセスして、モニターから送信されたメトリクスを検索します。詳細については、メトリクス・ファインダーとメタデータ・カタログを検索するを参照してください。

セットアップ 🔗

ソケットの設定 🔗

HAProxyソケットファイルの場所は、以下の例に示すように、HAProxy設定ファイルで定義されます：

global
    daemon
    stats socket /var/run/haproxy.sock
    stats timeout 2m

注： HAProxyの統計情報にはTCPソケットを使用できます。haproxy プラグイン設定ファイルで、ソケットの TCP アドレスを指定します。例えば、https://www.example.com/socket:9000 。以下の例のように、haproxy.cfgファイルで、statsソケットを同じTCPアドレスとポートを使用するように変更します：

global
    daemon
    stats socket localhost:9000
    stats timeout 2m

より制限されたTCPソケットを使用するには、以下の手順に従ってください：

localhost上のstatsをリッスンするバックエンドサーバーを定義します。
異なるポートでバックエンドサーバーと通信するフロントエンドプロキシサーバーを定義します。
両方のサーバーでACLを使用してアクセスを制御します。どの程度ソケットを制限するかにもよるが、以下のようにsignalfx-agentユーザーをhaproxyグループに追加する必要があるかもしれない： sudo usermod -a -G haproxy signalfx-agent

以下の設定ファイルは、バックエンドサーバーとフロントエンドプロキシを定義する方法を示しています：

global
    daemon
    stats socket localhost:9000
    stats timeout 2m

backend stats-backend
    mode tcp
    server stats-localhost localhost:9000

frontend stats-frontend
    bind *:9001
    default_backend stats-backend
    acl ...
    acl ...

SELinuxのセットアップ 🔗

SELinuxを有効にしている場合は、`タイプ・エンフォースメント・ファイル<https://github.com/signalfx/collectd-haproxy/blob/master/selinux/collectd-haproxy.te>`__ をサーバー上の任意の場所にダウンロードして、SELinuxポリシー・パッケージを作成します。以下のコマンドを実行して、ポリシー・パッケージを作成し、インストールします：

$ checkmodule -M -m -o haproxy.mod haproxy.te
checkmodule:  loading policy configuration from haproxy.te
checkmodule:  policy configuration loaded
checkmodule:  writing binary representation (version 17) to haproxy.mod
$ semodule_package -o haproxy.pp -m haproxy.mod
$ sudo semodule -i haproxy.pp
$ sudo reboot

インストール 🔗

このインテグレーションを導入するには、以下の手順に従ってください：

Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
[設定] セクションの説明に従ってインテグレーションを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。

設定 🔗

Smart Agent モニターとCollector のインテグレーションを使用するには、以下の手順に従います：

Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

Collector でSmart Agent モニターを使用するの方法を参照してください。
Smart Agent レシーバーの設定方法を参照してください。
一般的な設定オプションのリストについては、モニターの共通設定を参照してください。
Collectorの詳細は、はじめに：Collectorを理解して使用するを参照してください。

例 🔗

このインテグレーションを有効にするには、Collector構成に以下を追加します：

receivers:
    smartagent/haproxy:
        type: haproxy
        ...  # Additional config

次に、設定ファイルの service.pipelines.metrics.receivers セクションにモニターを追加します：

service:
  pipelines:
    metrics:
      monitors: [smartagent/haproxy]

設定オプション 🔗

次の表に、このモニターの設定オプションを示します：

オプション	必須	タイプ	説明
`pythonBinary`	いいえ	`string`	Pythonコードを実行するために使用するpythonバイナリへのパス。設定されていない場合、組み込みのランタイムが使用されます。バイナリに引数を含めることもできます。
`host`	はい	`string`
`port`	いいえ	`integer`	(デフォルト： `0` )
`proxiesToMonitor`	いいえ	`list of strings`	モニターするすべての pxname または svname のリスト（例： `["http-in", "server1", "backend"]` ）
`excludedMetrics`	いいえ	`list of strings`	非推奨。代わりにモニター設定ブロックでは `datapointsToExclude` を使用してください。
`enhancedMetrics`	いいえ	`bool`	(デフォルト： `false` )

メトリクス 🔗

このインテグレーションでは、以下のメトリクスを使用できます：

備考 🔗

To learn more about the available in Splunk Observability Cloud see メトリクスタイプ
In host-based subscription plans, default metrics are those metrics included in host-based subscriptions in Splunk Observability Cloud, such as host, container, or bundled metrics. Custom metrics are not provided by default and might be subject to charges. See メトリクスカテゴリ for more information.
MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。
メトリクスを追加するには、その他のメトリクスの追加で extraMetrics の設定方法を参照してください。

トラブルシューティング 🔗

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

Submit a case in the Splunk Support Portal .
Contact Splunk Support .

見込み客および無料トライアルユーザー様

Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルのチャットグループを参照してください。

This page was last updated on 2024年09月18日.

Related Topics