HAProxyモニタリングの統合

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

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

互換性と要件

インストレーション前に、以下の要件を満たしていることを確認してください。

NewRelicアカウント。持っていませんか？無料でお申し込み頂けます！クレジットカードは必要ありません。
HAProxy バージョン 1.3 ～ 2.x。
HAProxy統計ページが有効になり、アクセスできるようになりました。

クイックスタート

Kubernetes または ECS 環境で HAProxy を実行していない場合は、ガイド付きインストールをお勧めします。ガイド付きインストールでは、インフラストラクチャエージェントと CLI を使用して HAProxy 統合をセットアップし、環境内で実行されている他のアプリケーションとログソースを検出して、どのアプリケーションを計測する必要があるかを推奨します。

ガイド付きインストールは、ほとんどの設定と連動します。ただし、ご希望に添えない場合は、以下の他のインストールオプションがあります。

始める準備はできていますか？使用するデータセンターの地域に応じて、該当するボタンをクリックします。インストールが完了したら、本ドキュメントに戻って設定オプションを確認してください。

ガイド付きインストール（米国オプション）

ガイド付きインストール（EUオプション）

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

ガイド付きインストールを使用しない場合は、ご使用の環境に応じた手順に従ってください。

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

インフラストラクチャエージェントをインストールし、 INTEGRATION_FILE_NAME変数をnri-haproxyに置き換えます。
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構成ファイルを編集します。

統合を更新する

このインテグレーションは、自動更新しません。最善の結果を得るため、インテグレーションパッケージの更新とInfrastructureエージェントの更新を定期的に実施してください。

インストール後のタスク

インストールが完了したら、設定オプションを設定できます。インテグレーションを機能させるには、設定がいくつか必要ですが、オプションの設定もあります。

統合を構成する

ECSまたはKubernetesインテグレーションからこのインテグレーションを有効にした場合は、以下のドキュメントを参照してください。

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

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

従来の構成/定義ファイルをまだ使用している場合は、オンホスト統合の標準構成形式のヘルプを参照してください。

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

HAProxy 構成オプション

Apacheインテグレーションは、メトリクスとインベントリの両方の情報を収集します。この表は、各設定オプションが何に適用されるかを示しています。

'' '' '' '' ''

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

これらの設定の値は、いくつかの方法で定義できます。

設定ファイルに直接値を追加します（最も一般的な方法）。
{{}}表記を使用して、環境変数の値を置き換えます。これには、Infrastructureエージェントバージョン1.14.0以降が必要です。詳細については、Infrastructure設定または環境変数の例を参照してください。
シークレット管理の使用。これを使用して、設定ファイルのプレーンテキストで公開されないようにパスワードなどの重要な情報を保護してください。詳細については、シークレット管理を参照してください。

ラベル

さらに、メトリクスにラベルを付けることもできます。ラベルを使用すると、属性（キーや値のペア）をメトリクスに追加して、メトリクスのクエリを挙げ、フィルターをかけ、グループ化を行うことができます。

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

labels:
   env: production
   role: load_balancer

構成例

以下に、YAML設定の例をいくつか示します。

これは、ローカルホストから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

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

この統合からのデータは、 one.newrelic.com > Infrastructure > Third-party services > HAProxyに移動して見つけることができます。

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

HAProxyBackendSample
HAProxyFrontendSample
HAProxyServerSample

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

データの検索と使用方法の詳細については、「統合データについて」を参照してください。この統合のデータは、専用の New Relic ダッシュボードにレポートされます。

メトリックデータ

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`	サーバーのセッション制限です。

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

このインテグレーションはオープンソースソフトウェアです。つまり、ソースコードを参照して改善を送信したり、独自のフォークを作成して構築したりできます。

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