レシーバー(プラットフォーム)
ストリーミングレシーバーの概要
Apstraサーバーは、アラート、イベント、パーフモン、またはそれらの任意の組み合わせをストリーミングするように設定できます。各データタイプは、独自のTCPソケットを介してストリーミングレシーバーに送信されます。3つのデータタイプすべてが同じストリーミングレシーバーに設定されている場合でも、Apstraサーバーとストリーミングレシーバーの間に3つの接続が作成されます。これにより、3 つのタイプすべてが 3 つの異なるストリーミング レシーバーに送信することもできます。
レシーバには、以下の詳細が含まれます。
- ホスト名 - ホスト名
- ポート - デフォルト:4444
- メッセージ タイプ - アラート、イベント、パフォーマンス
- シーケンス モード - 並び替えなし、順序付け
左側のナビゲーション メニューから 、プラットフォーム > ストリーミング >レシーバ に移動し、受信者に移動します。レシーバを登録および削除することができます。
レシーバの作成
- Apstra GUIの左ナビゲーションメニューから、プラットフォーム>ストリーミング>レシーバに移動し、[レシーバの作成]をクリックします。
- 必要な値を入力/選択します。
- [作成] をクリックしてレシーバを作成し、テーブル ビューに戻ります。
受信者の削除
- Apstra GUIの左ナビゲーションメニューから、レシーバのプラットフォーム>ストリーミング>に移動し、受信者が削除する削除ボタンをクリックします。
- [削除] をクリックすると、レシーバがシステムから削除され、テーブル ビューに戻ります。
Telegrafプラグインを使用してレシーバーを設定する
Apstra Telegraf入力プラグインを使用して、Apstraからストリーミングテレメトリを受け取ることができます。 Telegraf は、メトリックの収集、処理、集約、および書き込みを行うエージェントです。これは、Apstra環境からの protobuf メッセージの受信を処理する AOSOM-Streaming のコンポーネントです。詳細については、 AOSOMストリーミングガイドを参照してください。Telegrafプラットフォームは、メトリックを集約してさまざまなバックエンドデータベースに保存するために選択できる入出力プラグインで構成されています。Telegraf用のApstra入力プラグインは、protobufストリームを逆シリアル化し、Prometheus、InfluxDB、Elasticsearchなどの特定のバックエンドデータベースに送信できるメトリックを作成します。
ここで説明する設定は、Apstra Telegraf入力プラグインを使用していることを前提としています。Apstraの認証情報を提供することで、TelegrafプラグインでApstraのストリーミングレシーバーを設定できます。ストリーミング認証情報のみで個別のApstraアカウントを使用することをお勧めします。GUIで設定する場合、Telegrafの設定ファイルに認証情報を入力する必要はありません。
Telegrafレシーバーを実行する最も簡単な方法は、Dockerコンテナです。以下のスニペットは docker-compose.yml
、Telegraf コンテナの設定を示しています。これにより、Docker Hubから、Apstraでサポートされている最新のTelegrafコンテナがプルされます。
# Telegraf container config telegraf-prom: image: apstra/telegraf:latest command: telegraf volumes: - ./config/telegraf-prom.toml:/etc/telegraf/telegraf.conf ports: - '9999:9999'
Telegraf 設定ファイル - ./config/telegraf-prom.toml
は、コンテナ上で にマッピングされます /etc/telegraf/telegraf.conf
。以下のパラメーターが含まれています。
- アドレス - ストリーミングレシーバーのIPアドレスを指定します。
- ポート - ストリーミングレシーバーがリッスンするポートを指定します。
- streaming_type - Apstraからこの受信者にストリーミングするデータの種類を指定します。
残りのパラメータは、Apstra TelegrafプラグインでAPIを介してApstraのストリーミングレシーバーを設定したい場合にのみ必要です。
- aos_server - ApstraサーバーのIPアドレスを指定します。
- aos_port - 常に443にする必要があります
- aos_login - Apstrs ユーザー名
- aos_password - Apstraパスワード
入力および出力プラグインの構成は、以下のスニペットに示されています。出力プラグインはPrometheusクライアント用に設定されており、ポート9126でリッスンします。入力プラグインはApstra用に設定されています。
# Configuration for Prometheus server to expose metrics [[outputs.prometheus_client]] listen = ":9126" expiration_interval = "0" [[inputs.aos]] address = "10.1.1.200" port = 9999 streaming_type = [ "perfmon", "alerts", "events" ] aos_server = "$AOS_SERVER" aos_port = $AOS_PORT aos_login = "$AOS_LOGIN" aos_password = "$AOS_PASSWORD"