HAProxyモニタリングの統合

当社のHAProxy 統合は、HAProxyインスタンスからインベントリやメトリクスを収集してNew Relicプラットフォームに送信し、HAProxyサーバー、フロントエンド、バックエンドの主要なパフォーマンスメトリクスを集約して可視化することができます。

統合をインストールし、収集するデータを確認するために読んでください。

互換性と要件

この統合は、HAProxy バージョン 1.3 ～ 2.x と互換性があります。

統合をインストールする前に、次の要件を満たしていることを確認してください。

HAProxy統計ページが有効になり、アクセスできるようになりました。
HAProxyがKubernetesまたはAmazon ECS上で 実行されていない場合は、 HAProxyを実行しているホストにインフラストラクチャエージェントをインストールする必要があります。それ以外の場合は
- Kubernetesで実行している場合は、これらの要件を参照してください。
- ECSで実行している場合は、これらの要件を参照してください。

クイックスタート

ガイド付きインストールで、HAProxy インスタンスをすばやくインスツルメントし、テレメトリーデータを送信します。ガイド付きインストールでは、お客様の環境に合わせてカスタマイズされたCLIコマンドを作成し、New Relic CLIとインフラストラクチャエージェントのダウンロードとインストールを行います。

始める準備はできましたか？これらのボタンのいずれかをクリックして試してください。

ガイド付きインストール

EUガイド付きインストール

ガイド付きインストールでは、インフラストラクチャエージェントを使用してHAProxyの統合を設定します。それだけでなく、お客様の環境で稼働している他のアプリケーションやログソースを検出し、どのアプリケーションを導入すべきかを推奨します。

ガイド付きインストールは、ほとんどのセットアップに対応しています。しかし、この方法がお客様のニーズに合わない場合は、以下の他の方法でHAProxyインスタンスの監視を始めることができます。

インストールしてアクティブ化する

HAProxyインテグレーションをインストールするには、お使いの環境に応じた手順に従ってください。

インフラストラクチャエージェントをインストールし、 INTEGRATION_FILE_NAME変数をnri-haproxyに置き換えます。
ディレクトリを統合フォルダに変更します。
```
cd /etc/newrelic-infra/integrations.d
```
サンプル構成ファイルをコピーします。
```
sudo cp haproxy-config.yml.sample haproxy-config.yml
```
構成設定の説明に従って、 haproxy-config.ymlファイルを編集します。
インフラストラクチャエージェントを再起動します。

nri-haproxy .MSIインストーラーイメージを以下からダウンロードします。
https://download.newrelic.com/infrastructure_agent/windows/integrations/nri-haproxy/nri-haproxy-amd64.msi
Windowsコマンドプロンプトからインストールするには、次のコマンドを実行します。
```
msiexec.exe /qn /i PATH\TO\nri-haproxy-amd64.msi
```
IntegrationsディレクトリC:\Program Files\New Relic\newrelic-infra\integrations.d\で、次のコマンドを実行してサンプル構成ファイルのコピーを作成します。
```
cp haproxy-config.yml.sample haproxy-config.yml
```
構成設定を使用してhaproxy-config.yml構成ファイルを編集します。
インフラストラクチャエージェントを再起動します。

その他の注意事項：

高度：統合はtarball形式でも利用可能であり、パッケージマネージャーの外部にインストールできます。
オンホスト統合は自動的に更新されません。最良の結果を得るには、統合パッケージとインフラストラクチャエージェントを定期的に更新してください。

このドキュメントはインストールで役立ちましたか。

統合を構成する

統合機能を設定するには、インストール方法に応じていくつかの方法があります。

Kubernetes経由で有効な場合は、を参照してください。 Kubernetes上で実行されているサービスを監視する。
Amazon ECS経由で有効な場合は、 ECS上で動作しているサービスの監視を参照してください。
オンホスト経由でインストールされている場合は、統合のYAML構成ファイルhaproxy-config.ymlの構成を編集します。

統合のYAML形式の構成では、必要なログイン資格情報を配置し、データの収集方法を構成できます。どのオプションを変更するかは、セットアップと設定によって異なります。

構成ファイルには、 interval 、 timeout 、 inventory_sourceなどのすべての統合に適用できる共通の設定があります。これらの一般的な設定についてすべて読むには、構成フォーマットのドキュメントを参照してください。

従来の設定/定義ファイルをまだお使いの場合は、on-host integrations standard configuration format を参照してください。

HAProxy に関連する特定の設定は、構成ファイルのenvセクションを使用して定義されます。これらの設定は、HAProxy インスタンスへの接続、およびその他のセキュリティ設定と機能を制御します。

HAProxyインスタンスの設定

HAProxyインテグレーションでは、メトリクス(M)とインベントリ(I)の両方の情報を収集します。表の中で、 Applies To の欄には、各コレクションで利用できる設定が記載されています。

'' '' '' '' ''

設定	説明	デフォルト	に適用されます
STATS_URL	HAProxyの統計情報ページを示すURLです。	該当なし	M / I
ユーザー名	HAProxy接続用のユーザー名。	該当なし	M / I
パスワード	指定されたユーザーのパスワード。	該当なし	M / I
ha_proxy_cluster_name	監視対象のクラスターを一意に識別するためのユーザー定義の名前。必須.	該当なし	M / I
METRICS	メトリックのみの収集を有効にするには、 `true`に設定します。	false
在庫	インベントリのみの収集を有効にするには、 `true`に設定します。	false

これらの設定値は、以下の方法で定義することができます。

コンフィグファイルに直接値を追加します。
{{}}表記を使用して、環境変数の値を置き換えます。これには、インフラストラクチャエージェント v1.14.0 以降が必要です。ここで詳細を読むか、以下の例を参照してください。
シークレット管理を使用して、パスワードなどの機密情報が構成ファイル内のプレーンテキストで公開されないように保護します。詳細については、シークレット管理を参照してください。

ラベル/カスタム属性

また、ラベルを使ってメトリクスを装飾することもできます。このような場合は、次のようになります。また、ラベルを使用して、メトリクスの照会、フィルタリング、またはグループ化を行うことができます。

デフォルトのサンプル設定ファイルにはラベルの例が含まれていますが、お好みのラベルを削除、変更、または追加することができます。

labels:
   env: production
   role: load_balancer

構成例

これは、ローカルホストからMetricsとInventoryを収集するための基本的な構成です。

integrations:
  - name: nri-haproxy
    env:
      STATS_URL: http://haproxy-instance/stats
      USERNAME: haproxy_user
      PASSWORD: haproxy_password
      HA_PROXY_CLUSTER_NAME: haproxycluster
    interval: 15s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/haproxy

この構成では、環境変数HAPROXY_STATSを使用して、統合の STATS_URL 設定を入力します。

integrations:
  - name: nri-haproxy
    env:
      METRICS: "true"
      STATS_URL: {{HAPROXY_STATUS}}
      USERNAME: haproxy_user
      PASSWORD: haproxy_password
      HA_PROXY_CLUSTER_NAME: haproxycluster
    interval: 15s
    labels:
      env: production
      role: load_balancer

この構成は、同じ統合から複数の HAProxy サーバーを監視します。最初のインスタンス ( STATUS_URL: https://1st_haproxy-instance/stats ) は指標とインベントリを収集し、2 番目のインスタンス ( STATUS_URL: https://2nd_haproxy-instance/stats ) は指標のみを収集します。

integrations:
  - name: nri-haproxy
    env:
      METRICS: "true"
      STATS_URL: http://1st_haproxy-instance/stats
      USERNAME: haproxy_user
      PASSWORD: haproxy_password
      HA_PROXY_CLUSTER_NAME: haproxycluster1
    interval: 15s
    labels:
      env: production
      role: load_balancer
  - name: nri-haproxy
    env:
      INVENTORY: "true"
      STATS_URL: http://1st_haproxy-instance/stats
      USERNAME: haproxy_user
      PASSWORD: haproxy_password
      HA_PROXY_CLUSTER_NAME: haproxycluster1
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/haproxy

  - name: nri-haproxy
    env:
      METRICS: "true"
      STATS_URL: http://2nd_haproxy-instance/stats
      USERNAME: haproxy_user
      PASSWORD: haproxy_password
      HA_PROXY_CLUSTER_NAME: haproxycluster2
    interval: 15s
    labels:
      env: production
      role: load_balancer

データを見つけて使用する

この統合のデータは、専用の New Relic ダッシュボードに報告されます。

メトリクスは以下のイベントタイプに付けられています。

HAProxyBackendSample
HAProxyFrontendSample
HAProxyServerSample

トラブルシューティングの目的で、またはカスタムチャートとダッシュボードを作成するために、このデータをクエリできます。

データを検索して使用する方法の詳細については、統合データについてを参照してください。

メトリックデータ

HAProxy 統合は、次のメトリックデータ属性を収集します。各指標名には、 backend. 、 frontend. 、 server.などのカテゴリインジケータとピリオドがプレフィックスとして付けられます。

HAProxyバックエンドのサンプルメトリクス

これらの属性は、 HAProxyBackendSampleイベントタイプに関連付けられています。

メトリック	説明
`backend.activeServers`	アクティブなサーバーの数。
`backend.averageConnectTimeInSeconds`	直近の1024回のリクエストにおける平均接続時間（単位：ミリ秒）。
`backend.averageQueueTimeInSeconds`	直近の1024件のリクエストの平均キュータイム（単位：ミリ秒）。
`backend.averageResponseTimeInSeconds`	直近の1024回のリクエストの平均応答時間（単位：ミリ秒）。
`backend.averageTotalSessionTimeInSeconds`	直近の1024回のリクエストの平均総セッション時間（単位：ミリ秒）。
`backend.backupServers`	バックアップサーバーの数。
`backend.bytesInPerSecond`	1秒あたりの受信バイト数。
`backend.bytesOutPerSecond`	1秒あたりの送信バイト数。
`backend.bytesThatBypassedCompressorPerSecond`	1秒間にHTTPコンプレッサーをバイパスしたバイト数。
`backend.connectingRequestErrorsPerSecond`	バックエンドサーバーへの接続でエラーが発生したリクエストの数（1秒あたり）。
`backend.connectionRetriesPerSecond`	1秒間にサーバーへの接続が再試行された回数。
`backend.cookieName`	クッキーの名前です。
`backend.currentQueuedRequestsWithoutServer`	サーバーが割り当てられていない現在のキューイングされたリクエスト。
`backend.currentSessions`	現在のセッションの数
`backend.dataTransfersAbortedByClientPerSecond`	1秒間にクライアントが中止したデータ転送の数。
`backend.dataTransfersAbortedByServerPerSecond`	1秒あたりにサーバーで中止されたデータ転送の数。
`backend.downtimeInSeconds`	トータルのダウンタイムを秒単位で表示しています。
`backend.http100ResponsesPerSecond`	1秒あたりの1xxコードのHTTPレスポンス。
`backend.http200ResponsesPerSecond`	1秒間に2xxコードを含むHTTPレスポンス。
`backend.http300ResponsesPerSecond`	1秒間に3xxコードを含むHTTPレスポンス。
`backend.http400ResponsesPerSecond`	1秒間に4xxコードを含むHTTPレスポンス。
`backend.http500ResponsesPerSecond`	1秒間に5xxコードを含むHTTPレスポンス。
`backend.httpOtherResponsesPerSecond`	その他のコード(プロトコルエラー)を含むHTTPレスポンスの1秒あたりの数値。
`backend.httpRequestsPerSecond`	1秒あたりのHTTPリクエスト数。
`backend.httpResponseBytesEmittedByCompressorPerSecond`	コンプレッサーが1秒あたりに出力するHTTPレスポンスバイト数。
`backend.httpResponseBytesFedToCompressorPerSecond`	1秒間にコンプレッサーに供給されるHTTPレスポンスのバイト数。
`backend.httpResponsesCompressedPerSecond`	1秒あたりに圧縮されたHTTPレスポンスの数。
`backend.interceptedRequestsPerSecond`	1秒あたりのインターセプトされたリクエスト数。
`backend.maxQueuedRequestsWithoutServer`	サーバーが割り当てられていないキューイングされたリクエストの最大値。
`backend.maxSessions`	最大セッション数
`backend.maxSessionsPerSecond`	1秒あたりの新規セッションの最大数です。
`backend.mode`	プロキシモードです。オプション：tcp、http、health、unknown。
`backend.proxyName`	プロキシの名前です。
`backend.requestRedispatchPerSecond`	1秒間にリクエストが別のサーバーに再送された回数。
`backend.requestsDenied.securityConcernPerSecond`	1秒あたりのtcp-request接続ルールで拒否されたリクエスト数。
`backend.responseErrorsPerSecond`	1秒あたりの応答エラー数
`backend.responsesDenied.securityConcernPerSecond`	1秒あたりのtcp-requestセッションルールで拒否されたリクエスト数。
`backend.serverSelectedPerSecond`	新規セッションや再派遣の際に、1秒間にサーバーが選択された回数。
`backend.sessionsPerSecond`	1秒間に作成されるセッション数。
`backend.status`	ステータスオプションです。UP、DOWN、NOLB、MAINT、MAINT(via)、MAINT(resolution)があります。
`backend.timeSinceLastSessionAssignedInSeconds`	バックエンドに最後のセッションが割り当てられてからの秒数。
`backend.timeSinceLastUpDownTransitionInSeconds`	前回の UP<->DOWN の遷移からの秒数。
`backend.totalWeight`	バックエンドの総重量。
`backend.type`	バックエンドのタイプ。`0` = フロントエンド、 `1` = バックエンド、 `2` = サーバー、 `3` = ソケット/リスナー。
`backend.upToDownTransitionsPerSecond`	1秒あたりのUP->DOWN トランジションの数。

HAProxyフロントエンドのサンプルメトリクス

これらの属性は、 HAProxyFrontendSampleイベントタイプに関連付けられています。

メトリック	説明
`frontend.bytesInPerSecond`	1秒あたりの受信バイト数。
`frontend.bytesOutPerSecond`	1秒あたりの送信バイト数。
`frontend.connectionsPerSecond`	1秒あたりの接続数。
`frontend.currentSessions`	現在のセッションの数
`frontend.http100ResponsesPerSecond`	1秒あたりの1xxコードのHTTPレスポンス。
`frontend.http200ResponsesPerSecond`	1秒間に2xxコードを含むHTTPレスポンス。
`frontend.http300ResponsesPerSecond`	1秒間に3xxコードを含むHTTPレスポンス。
`frontend.http400ResponsesPerSecond`	1秒間に4xxコードを含むHTTPレスポンス。
`frontend.http500ResponsesPerSecond`	1秒間に5xxコードを含むHTTPレスポンス。
`frontend.httpOtherResponsesPerSecond`	他のコード（プロトコルエラー）を含むHTTPレスポンス。
`frontend.httpRequests.maxPerSecond`	1秒間に観測される最大のHTTPリクエスト数。
`frontend.httpRequestsPerSecond`	1秒あたりのHTTPリクエスト数。
`frontend.interceptedRequestsPerSecond`	1秒あたりのインターセプトされたリクエスト数。
`frontend.maxConnectionsPerSecond`	最大接続数
`frontend.maxSessions`	最大セッション数
`frontend.maxSessionsPerSecond`	1秒あたりの新規セッションの最大数です。
`frontend.mode`	プロキシモード。tcp、http、health、unknownのいずれか。
`frontend.proxyName`	プロキシの名前です。
`frontend.requestErrors`	1秒あたりのリクエストエラー数
`frontend.requestsDenied.securityConcernsPerSecond`	セキュリティ上の理由で拒否されたリクエストの数/秒
`frontend.requestsDenied.tcpRequestConnectionRulesPerSecond`	1秒あたりのtcp-request接続ルールで拒否されたリクエスト数。
`frontend.requestsDenied.tcpRequestSessionRulesPerSecond`	1秒あたりのtcp-requestセッションルールで拒否されたリクエスト数。
`frontend.responsesDenied.securityConcernsPerSecond`	セキュリティ上の理由で回答が拒否されることが1秒間に1回あります。
`frontend.serviceName`	サービスの名前。
`frontend.sessionsPerSecond`	1秒間に作成されるセッション数。
`frontend.status`	フロントエンドの状態です。オプションです。UP、DOWN、NOLB、MAINT、MAINT(via)、MAINT(resolution)です。
`frontend.type`	フロントエンドのタイプ。`0` = フロントエンド、 `1` = バックエンド、 `2` = サーバー、 `3` = ソケット/リスナー。

HAProxyサーバのサンプルメトリクス

これらの属性は、 HAProxyServerSampleイベントタイプに関連付けられています。

メトリック	説明
`server.agentCheckContents`	最後にエージェントがコンテンツやテキストのエラーをチェックします。
`server.agentDurationInSeconds`	最後のチェックが終了するまでの時間（単位：ミリ秒）。
`server.agentStatus`	エージェントのステータス
`server.agentStatusDescription`	人間が読める短い`agent_status`の説明。
`server.averageConnectTimeInSeconds`	直近の1024回のリクエストにおける平均接続時間（単位：ミリ秒）。
`server.averageQueueTimeInSeconds`	直近の1024件のリクエストの平均キュータイム（単位：ミリ秒）。
`server.averageResponseTimeInSeconds`	直近の1024回のリクエストの平均応答時間（単位：ミリ秒）。
`server.averageTotalSessionTimeInSeconds`	直近の1024回のリクエストの平均総セッション時間（単位：ミリ秒）。
`server.bytesInPerSecond`	1秒あたりの受信バイト数。
`server.bytesOutPerSecond`	1秒あたりの送信バイト数。
`server.checkStatusDescription`	人間が読める短い`check_status`の説明。
`server.connectingToBackendRequestErrorsPerSecond`	バックエンドサーバーへの接続でエラーが発生したリクエストの数（1秒あたり）。
`server.connectionRetriesPerSecond`	1秒間にサーバーへの接続が再試行された回数。
`server.cookieValue`	サーバーのクッキーの値です。
`server.currentSessions`	現在のセッションの数
`server.dataTransfersAbortedByClientPerSecond`	1秒間にクライアントが中止したデータ転送の数。
`server.dataTransfersAbortedByServerPerSecond`	1秒あたりにサーバーで中止されたデータ転送の数。
`server.downtimeInSeconds`	トータルのダウンタイムを秒単位で表示しています。
`server.failedChecksPerSecond`	1秒間に失敗したチェックの数。
`server.failedHealthCheckDetails`	ヘルスチェックの詳細に失敗しました。
`server.healthCheckContents`	最後にヘルスチェックを行い、コンテンツやテキストのエラーを確認します。
`server.healthCheckDurationInMilliseconds`	最後のヘルスチェックが終了するまでの時間（単位：ミリ秒）。
`server.healthCheckStatus`	ヘルスチェック状態。
`server.http100ResponsesPerSecond`	1秒あたりの1xxコードのHTTPレスポンス。
`server.http200ResponsesPerSecond`	1秒間に2xxコードを含むHTTPレスポンス。
`server.http300ResponsesPerSecond`	1秒間に3xxコードを含むHTTPレスポンス。
`server.http400ResponsesPerSecond`	1秒間に4xxコードを含むHTTPレスポンス。
`server.http500ResponsesPerSecond`	1秒間に5xxコードを含むHTTPレスポンス。
`server.httpOtherResponsesPerSecond`	他のコード（プロトコルエラー）を含むHTTPレスポンス。
`server.isActive`	サーバーがアクティブかどうか。`0` = 非アクティブ、 `1` = アクティブ。
`server.isBackup`	サーバーがバックアップかどうか。`0` = バックアップなし、 `1` = バックアップ。
`server.layerCode`	レイヤ5-7のコードがあれば、それを入力します。
`server.maximumQueuedRequests`	キューイングされたリクエストの最大値。
`server.maxSessions`	最大セッション数
`server.maxSessionsPerSecond`	1秒間の最大セッション数
`server.mode`	プロキシモード。tcp、http、health、unknownのいずれか。
`server.proxyName`	プロキシの名前です。
`server.queuedRequests`	現在キューイングされているリクエスト
`server.requestRedispatchPerSecond`	1秒間にリクエストが別のサーバーに再送された回数。
`server.requestsDenied.securityConcernPerSecond`	セキュリティ上の理由で拒否されたリクエストの数/秒
`server.responseErrorsPerSecond`	1秒あたりの応答エラー数
`server.responsesDenied.securityConcernPerSecond`	セキュリティ上の理由で回答が拒否されることが1秒間に1回あります。
`server.serverID`	サーバーIDです。
`server.serverSelectedPerSecond`	新規セッションや再派遣の際に、1秒間にサーバーが選択された回数。
`server.serverWeight`	サーバーの重量です。
`server.serviceName`	サービスの名前。
`server.sessionsPerSecond`	1秒あたりのセッション数
`server.status`	サーバーの状態です。オプションです。UP、DOWN、NOLB、MAINT、MAINT(via)、MAINT(resolution)です。
`server.throttlePercentage`	スロースタートがアクティブな場合の、サーバのスロットルパーセンテージです。スロースタートを使用していない場合は、値はありません。
`server.timeSinceLastSessionAssignedInSeconds`	バックエンドに最後のセッションが割り当てられてからの秒数。
`server.timeSinceLastUpDownTransitionInSeconds`	前回の UP<->DOWN の遷移からの秒数。
`server.type`	サーバーのタイプ。`0` = フロントエンド、 `1` = バックエンド、 `2` = サーバー、 `3` = ソケット/リスナー。
`server.upToDownTransitionsPerSecond`	1秒あたりのUP->DOWN トランジションの数。

在庫データ

HAProxy インテグレーションでは、HAProxy インスタンスの構成パラメータを取得します。このデータは、インフラストラクチャの Inventory ページ、 config/haproxy ソースの下にあります。インベントリデータについては、 Understand integration data を参照してください。

インテグレーションでは、以下の設定パラメータのデータを取得します。

バックエンド在庫

名前	説明
`iid`	バックエンドプロキシのIDです。
`pid`	バックエンドのプロセスIDです。
`slim`	バックエンドのセッション制限です。

フロントエンド在庫

名前	説明
`iid`	フロントエンドのプロキシIDです。
`pid`	フロントエンドのプロセスIDです。
`rate_lim`	新しいセッション/秒の制限。
`slim`	フロントエンドのセッション制限です。

サーバーインベントリー

名前	説明
`iid`	バックエンドプロキシのIDです。
`pid`	サーバーのプロセスIDです。
`qmax`	設定された最大キュー。`0` = 制限なし。
`sid`	サーバーIDです。
`slim`	サーバーのセッション制限です。

ソースコードを確認してください

この統合はオープンソースソフトウェアです。つまり、ソースコードを参照して改善を送信したり、独自のフォークを作成してビルドしたりできます。

この機械翻訳は参考用に提供されます。