このページでは、New Relic のネットワーク監視で使用されるktranslateコンテナの管理オプションの概要を説明します。
コンテナの要件
ktranslateコンテナ イメージには次のリソースをお勧めします。
Disk
- 100MBの利用可能なディスクスペース
CPU
- SNMPポーリング/トラップ収集。約1,000台のデバイスに対して1CPUコアを使用
- デバイスのフロー収集。約2,000フロー/秒（fps）ごとに1CPUコアを使用
- Syslogメッセージの収集。1秒間に約2,000件のメッセージに対して1つのCPUコアを使用
Memory
- ktranslate 通常、メモリ リソースによる制約はありません。 ホスト上のメモリの量は、実行する予定のアプリケーション/コンテナの種類によって決まります。 一般的なアイデアとして、1 vCPU と 1.0 GB の利用可能な RAM を備えたAWS t2.microと同じくらい小さいイメージ サイズで成功することが一般的です。
ヒント
KTranslate コンテナ イメージは、一度に 1 つの「ジョブ タイプ」を実行します。たとえば、SNMP ポーリングとトラップ コレクション用にデプロイされたコンテナは、フロー コレクションには使用されません。さらに、フロー コレクション用にデプロイされたコンテナは、コンテナごとに 1 つの-nf.sourceタイプに制限されています。これは、単一の Docker ホストに複数のコンテナを同時にデプロイすることが一般的であることを意味します。また、共通の構成ファイルを共有することもできますが、その必要はありません。
コンテナの更新
ktranslateコンテナ イメージを最新の状態に保つことは、最新の更新を受信し、開発ライフサイクル中に適用されるさまざまなバグ修正を通じて一般的な問題を解決するために推奨されます。 コンテナを再デプロイするときは、常に最新の利用可能なイメージをプルすることをお勧めします。
以下のいずれかを実行して、利用可能な最新のコンテナイメージを引き出します。
既存のコンテナのIDと名前を収集します。
bash$docker ps -a --filter ancestor=kentik/ktranslate:v2 --format "{{.ID}} - {{.Names}}"出力例。
3297b134a352 - ktranslate-snmp4962a854b386 - ktranslate-sflow既存の容器の撤去
bash$docker rm -f $CONTAINER_IDSNMP 、フロー データ、またはsyslog コレクションのいずれかでデプロイした元の設定を使用して、 ktranslateコンテナを再デプロイします。
重要
ktranslateで使用される設定ファイルは実行時にコンテナに適用されます。 このファイルを変更するには、統合検出ジョブを使用する場合を除き、実行中のコンテナを削除して再起動し、編集内容を適用する必要があります。
コンテナのランタイムオプション
以下は、 Dockerランタイム中に ktranslate コンテナ イメージに対して使用できるさまざまなオプションです。
オプション名 | タイプ | 必須 | 説明 |
|---|---|---|---|
| 旗 | ✓✓ | 実行時にオプションとして渡されたDockerホストからのボリュームマウントに基づいて、Dockerコンテナ上の |
| 旗 | ✓✓ | ktranslateがデータを送信する New Relic アカウント ID。 |
| 旗 | ktranslateのデフォルトのinfoログレベルをオーバーライドします。 使用可能なオプションは | |
| 旗 | コンテナーをSNMP検出モードでセットアップして、単一の検出ジョブを実行し、提供されたYAML構成ファイルを更新して、終了するために使用されます。 | |
| 旗 | 固定間隔で実行するようにスケジュールされた SNMP ポーリング コンテナ内でintegrated discovery jobsを設定するために使用されます。 この設定により、検出ジョブが実行され、提供された YAML 構成ファイルが更新され、SNMP ポーリング コンテナーで SNMP 収集スレッドが再起動され、検出されたデバイスのコンテナー全体を破棄/再起動する必要がなくなります。 | |
| 旗 |
| |
| 旗 | オンデマンドでターゲットデバイスをポーリングするようにコンテナを設定するために使用します。 | |
| 旗 | Dockerを ktranslate からNew Relic Logsに転送します。 | |
| 旗 | ヘルスメトリクスをktranslateから New Relic に転送します。 | |
| 旗 | Dockerログのコンテナ名に追加され、NewRelicLogのさまざまなコンテナからログを分離できるようになります。 | |
| 旗 | テレメトリーをNew Relicに転送するために、ktranslate のリージョン API エンドポイントを設定します。 オプションは | |
| 旗 | 大量のデータを処理できます。送信されるネットワークフローデータの毎秒2,000フロー（fps）ごと、監視対象のSNMPデバイス1,000ごと、またはコンテナによって収集される毎秒2,000のsyslogメッセージごとに1つのCPUコアを使用することをお勧めします。デフォルトは | |
| 旗 | フローがNewRelicイベントに渡されるデフォルトのサンプルレート値を変更します。これにより、デバイスのフローサンプルレートのローカル構成が高速化されることはありませんが、速度が低下する可能性があります。これを | |
| 旗 | ネットワークパケットの処理に使用されるワーカーの数を上書きします。送信されるネットワークフローデータの毎秒4,000フロー（fps）ごとに1つのワーカーを使用します。デフォルトは | |
| 旗 | 着信フローパケットのリスニングポートを上書きします。デフォルトは | |
| 旗 | このコンテナが処理するフローのタイプを設定します。オプションは | |
| 旗 | ランタイム中にオプションとして渡されたDockerホストからのボリュームマウントに基づいて、Dockerコンテナ上の アプリケーションマップ ファイルへのパスを設定します。 | |
| 旗 | IP アドレスの DNS 解決中に使用するktranslateの | |
| 議論 | ✓ （フロー容器の場合） | この引数は、フラグ |
| 議論 | ✓ (SNMPコンテナの場合) | この引数は、次のオプションを静的に設定します： |
| 議論 | ✓ (syslogコンテナの場合) | この引数は、次のフラグを静的に設定します： |
| 旗 | syslog メッセージを解析するための形式。 オプションは
| |
| 旗 | Syslog サーバーを実行する IP:ポート タプル。 デフォルト： | |
| 環境変数 | ✓✓ | DockerNew Relicktranslateにデータを送信するために、New RelicAPI ランタイム中に、 用の を保持するために使用する必要がある環境変数。例: |
| 環境変数 | プロキシ経由で にデータを送信するように をセットアップするために ランタイム中に使用できる環境変数。DockerktranslateNew Relic例: | |
| 環境変数 | docker 実行時に使用できる環境変数。ICMP パケットのデフォルトの特権モードではなく、非特権モードで使用される UDP パケットを使用するようにktranslate's | |
| 環境変数 | Dockerランタイム中にMeraki ダッシュボード API キーをktranslate に渡すために使用できる環境変数。 例: | |
環境変数 | dockerランタイム中に AWS、Azure、または GCP からシークレットを取得するために使用できる環境変数。 |