Linux のモニタリング・エージェントのカスタマイズ
デフォルトでは、モニタリング・エージェントはさまざまなプラットフォームおよびアプリケーションからデータを収集します。 エージェントの構成ファイルを編集して、そのデフォルトの動作を変更し、データを含めたり、除外したりできます。 モニタリング・エージェントの構成ファイルをカスタマイズして、JMX、StatsD、Prometheus などのカスタム・メトリックを含めることができます。 また、メトリックやコンテナーをフィルターで除外できます。
モニタリング・エージェントでは、自動的に収集されるデータを指定する 2 つの構成ファイルが使用されます。
| ファイル | 説明 | Location |
|---|---|---|
dragent.default.yaml |
メイン・コンフィギュレーション・ファイル 重要: このファイルは編集しないでください。 |
/opt/draios/etc/dragent.default.yaml |
dragent.yaml |
モニタリング・エージェントをカスタマイズするために編集する構成ファイル。 | /opt/draios/etc/dragent.yaml |
dragent.yaml ファイルを編集して、収集されるデータをカスタマイズできます。 ファイルを保存すると、すぐに変更内容が有効になります。 エージェントは変更を検出し、自動的に再始動されます。 モニタリング・エージェントが検査する頻度やファイルは、dragent.default.yaml ファイルで確認できます。
例えば、dragent.default.yaml に以下の情報が含まれているとします。
check_frequency_s: 5
files:
- /opt/draios/etc/dragent.yaml
- /opt/draios/etc/kubernetes/config/dragent.yaml
- /opt/draios/etc/kubernetes/secrets/access-key
dragent yaml ファイルの編集
yaml ファイルは、/opt/draios/etc/ にあります。
ファイルを編集して変更内容を適用するには、以下のステップを実行します。
-
dragent.yaml に直接アクセスします。 このファイルは
/opt/draios/etc/dragent.yamlにあります。 -
ファイルを編集します。 有効な YAML 構文を使用してください。
-
エージェントを再始動します。 以下のコマンドを実行します。
service dragent restart
ポートのブロック
ネットワーク・ポートからのネットワーク・トラフィックおよびメトリックをブロックするには、dragent.yaml ファイルの blacklisted_ports セクションをカスタマイズする必要があります。 データをフィルターで除外するポートをリストする必要があります。
注: ポート 53 (DNS) は常にブラックリストに含まれます。
例えば、以下のサンプルは、ポート 6666 および 6379 からのデータを除外するようにモニタリング・エージェントの blacklisted_ports セクションを設定する方法を示しています。
blacklisted_ports:
- 6666
- 6379
メトリックの組み込みと除外
カスタム・メトリックをフィルタリングするには、dragent.yaml ファイルの metrics_filter セクションをカスタマイズする必要があります。 include と exclude のフィルタリング・パラメーターを構成して、含めるメトリックおよびフィルターで除外するメトリックを指定できます。
注: フィルタリング規則の順序は、メトリックに一致する最初のルールが適用されるように設定されています。
例えば、モニタリング・エージェントの metrics_filter セクションが以下のようであるとします。
metrics_filter:
- include: metricA.*
- exclude: metricA.*
- include: metricB.*
- include: haproxy.backend.*
- exclude: haproxy.*
- exclude: metricC.*
- metricA、metricB、および haproxy.backend で始まるメトリックからのすべてのデータを収集するモニタリング・エージェントを構成しています。
- metricC で始まるメトリックおよび haproxy で始まるその他のメトリックをフィルターで除外します。
- エントリー
exclude: metricA.*は無視されます。
ログ・レベルの変更
ログ・レベルを構成するには、dragent.yaml ファイルの log セクションをカスタマイズする必要があります。
モニタリング・エージェントが /opt/draios/logs/draios.log にログ・エントリーを生成します。
- ログ・ファイルのサイズが 10 MB に達すると、ログ・ファイルが交替します。
- 最新の 10 個のログ・ファイルが保持されます。 ファイル名に付加される日付スタンプが、保持するファイルの判別に使用されます。
- 有効なログ・レベルは、none、error、warning、info、debug、および trace です。
- デフォルトのログ・レベルは info です。警告およびエラーのエントリー以外に、1 秒あたり 1 回のバックエンド・サーバーへの集計メトリック伝送ごとにエントリーが作成されます。
- モニタリング・エージェントの構成ファイル /opt/draios/etc/dragent.yaml を構成して、収集されるログおよびエントリーのタイプをカスタマイズできます。 このファイルを編集した後に、
service dragent restartを使用してシェルでエージェントを再始動し、変更内容をアクティブ化する必要があります。
| ユース・ケース | log セクションのエントリー |
|---|---|
| エージェントの動作のトラブルシューティング | file_priority: debug |
| コンテナー・コンソールの出力の削減 | console_priority: warning |
| 重大度別のイベントのフィルター処理 | event_priority: warning |
| 含まれるメトリックと除外されるメトリックの確認 | metrics_excess_log: true |