Juniper NETWORKS ブロードバンド エッジ イベントの収集と視覚化

このガイドについて
このガイドを使用して、Broadband Edge Event Collection and Visualization をインストールします。

ブロードバンド エッジ イベントの収集と視覚化のインストール

• ブロードバンド エッジ イベントの収集と視覚化をインストールする | 2
• ブロードバンド エッジ イベント収集および視覚化ユーティリティ コマンドの使用方法 | 11

ブロードバンド エッジ イベントの収集と視覚化をインストールする

まとめ
このセクションでは、ブロードバンド エッジ イベントの収集と視覚化のインストール手順とシステム要件について説明します。

ブロードバンド エッジ (BBE) イベント収集および視覚化は、ジュニパー BNG CUPS コントローラーやアドレス プール マネージャー (APM) などのジュニパーの BBE クラウド アプリケーションで動作することを目的としたイベント収集アプリケーションです。 BBE Event Collection and Visualization は、syslog イベントを収集し、時系列データベースに記録します。あなたはできる view BBE Event Collection and Visualization Dashboard を通じて記録されたイベント。 BBE イベント収集および視覚化ダッシュボードは、次のことを可能にする GUI ベースの視覚化ツールです。 view 定義されたフィルターに従ってイベントを記録します。これは、特定の時間範囲内にすることができます。ダッシュボードには、複数のソースから記録されたイベントを関連付けることができる強力な検索および視覚化ツールも用意されています (例:ampファイル、APM または Kubernetes クラスターから)。

始める前に

BBE Event Collection and Visualization のインストールと実行を開始する前に、次のものが揃っていることを確認してください。

• BBE Event Collection and Visualization ソフトウェア パッケージをダウンロードする権限を持つ juniper.net ユーザー アカウント。
• 車のインストールを実行するために、Ubuntu 22.04 LTS (またはそれ以降が必要) を実行する Linux ホスト (ジャンプ ホスト)。
• ジャンプ ホストには次のものが必要です。
• CPU コア - 2
• RAM - 8 GB
• ディスク容量 - 128 GB の空きディスク ストレージ
• Python 3仮想環境がインストールされている
• Kubernetes クラスターにアクセスできるユーザー ログイン
• BBE イベント収集と視覚化のデプロイに必要なオープンソース コンテナ イメージをプルするための Docker Hub (docker.io) への外部アクセス。
• クラスターには少なくとも 22.04 つのワーカー ノード (仮想マシンまたは物理マシン) が必要です。ノードは、管理アドレスとドメイン名を持つ、Ubuntu XNUMX LTS (またはそれ以降) を実行する Linux システムです。ノードは次のシステム要件を満たしている必要があります。
• CPU コア - 8 (ハイパースレッディングを推奨)
• RAM - 64 GB
• ディスク容量 - ルート パーティションに 512 GB の空きディスク ストレージ

ブロードバンド エッジ イベントの収集と視覚化をインストールする
まとめ

• この手順を使用して、BBE Event Collection and Visualization をインストールします。
• 開始する前に、BBE Event Collection and Visualization のインストール要件を満たしていることを確認してください。

注記： BBE Cloudsetup 機能のインストールと Kubernetes クラスターの構築の手順については、『BBE Cloudsetup インストール ガイド』を参照してください。各セットアップ中に bbecloudsetup オプションを使用する場合、すべてのデフォルトは BBE Cloudsetup と一致します [–bbecloudsetup]。セットアップで bbecloudsetup オプションを使用しない場合は、BBE Event Collection and Visualization のインストールを開始するときに次の情報が必要です。

• Kubernetes レジストリの場所
• レジストリ名
• レジストリポート

BBE イベント収集および視覚化アプリケーションをインストールする

1. ジュニパーネットワークスのソフトウェア ダウンロード ページから BBE Event Collection and Visualization ソフトウェア パッケージをダウンロードし、ジャンプ ホストに保存します。
   BBE イベントの収集と視覚化は、圧縮された tarball イメージ (.tgz) として利用できます。の file名前には、名前の一部としてリリース番号が含まれます。リリース番号の形式は次のとおりです。
   ..
   • メジャーは製品のメイン リリース番号です。
   • マイナーは製品のマイナー リリース番号です。
   • メンテナンスはリビジョン番号です。
2. BBE Event Collection and Visualization tarball (.tgz) を解凍します。 file ジャンプ ホスト上で次のように入力します。
   注記： BBE イベントの収集と視覚化 fileは bbe-ecav ディレクトリに解凍されます。
3. tarball を解凍した後、ローダー スクリプトを実行します。
4. sudo -E ecav link –context context-name –version ecav-version コマンドを使用して、クラスターにリンクします。 link コマンドは、セットアップの準備として、ロードされた BBE Event Collection and Visualization ソフトウェア パッケージをクラスターに関連付けます。
   • context-name - Kubernetes コンテキスト名 (クラスター名)。
   • av-version - BBE イベント収集および視覚化ソフトウェアのバージョン。
5. 安全なレジストリを使用している場合 (例:ampファイル (BBE Cloudsetup によって作成されたクラスター) を使用し、システム ユーザー (BBE Cloudsetup クラスター構成で提供されるシステムおよびユーザー情報) として docker ログインを発行してレジストリで認証します。 file) をクラスターのレジストリ トランスポート アドレス (BBE Cloudsetup クラスター構成でシステム アドレスとして指定された FQDN) に送信します。 file).
6. セットアップを実行してインストールを構成します。 BBE Cloudsetup を使用してクラスターを構築した場合は、セットアップ コマンドに –bbecloudsetup オプションを追加して、レジストリ、ログ スタッシュ サービス、および OpenSearchDB レプリケーション数のデフォルトを受け入れることができます。セットアップ中に次の情報を入力する必要があります。
   • A URL BBE イベント収集および視覚化ダッシュボードへのアクセス用。 BBE Cloudsetup で使用されるシステム アドレスの DNS 名を入力します。
   • 管理者パスワード (長さは XNUMX 文字以上で、大文字、小文字、数字、および特殊文字を少なくとも XNUMX つずつ含める必要があります)。
   • context-name - Kubernetes コンテキスト名 (クラスター名)。
   • bbecloudsetup - BBE Cloudsetup が Kubernetes クラスターを作成したときに使用されたデフォルト値を使用します。
     setup コマンドは、次のようなクラスター環境に関する情報を収集します。コンテナー レジストリの場所、イングレス URL、OpenSearch レプリケーション数など。
7. BBE Event Collection and Visualization のインストールが version –context context-name — 詳細であることを確認します。

• context-name - Kubernetes コンテキスト名 (クラスター名)。

ブロードバンド エッジ イベントの収集と視覚化を開始する

まとめ
BBE イベントの収集と視覚化を開始するには、次の手順を使用します。

rollout と入力して、BBE Event Collection and Visualization のインストールを開始します。 BBE Event Collection and Visualization ユーティリティを使用すると、BBE Event Collection and Visualization の一部であるすべてのマイクロサービスに対してさまざまなソフトウェア バージョンをロールアウトできます。 root として sudo を使用してロールアウト コマンドを使用する必要があります。また、ロールアウト コマンドは、新しいリリースに必要なすべての値が存在することを検証し、新しいリリースのコンテナ イメージをレジストリにロードします。 sudo -E can rollout –context contextName [–version software-release ] を使用して、BBE イベント収集および視覚化サービスを開始します。元の場合amp上：

• context-name - Kubernetes コンテキスト (クラスター名)。
• 各 status –detail –context context-name を入力して、BBE Event Collection および Visualization サービスが稼働していることを確認します。元の場合amp上：

• context-name - Kubernetes コンテキスト (クラスター名)。

注記： 次のいずれかが発生した場合は、サービスのためにログを収集し、ジュニパーネットワークス テクニカル アシスタンス センター (JTAC) に連絡してください。

• サービスが実行されていません。
• 他のサービスと比較したサービスの稼働時間は、サービスが再起動されたことを示しています。

ブロードバンド エッジ イベントの収集および視覚化ダッシュボードの使用
BBE Event Collection and Visualization ダッシュボードを使用して、ログを検索したり、レポートを生成したりできます。レポートは、問題レポートの生成や一般的なデバッグに役立ちます。
ブロードバンド エッジ イベントの収集および視覚化ダッシュボードの詳細については、OpenSearch のドキュメントを参照してください。 https://opensearch.org/docs/2.9/dashboards/quickstart/.

表示するインデックスパターンを確立する

BBE Event Collection and Visualization ダッシュボードの使用を開始するには、まずダッシュボードに表示するインデックス パターンを確立する必要があります。
インデックス パターンを確立するには、次の手順を実行します。

1. ログイン URL BBE Event Collection and Visualization のインストール プロセス中に設定した BBE Event Collection and Visualization ダッシュボード アクセス用。ログインするには、BBE Event Collection and Visualization のセットアップ時に指定した管理ユーザー名とパスワードを使用します。
2. ダッシュボードに表示するインデックス パターンを確立します。

注記： インデックス パターンに一致するイベントがあるように、最初に BBE アプリケーションをインストールしてロールアウトすることをお勧めします。一致するインデックスが少なくとも XNUMX つある場合にのみ、インデックス パターンを作成できます。

• ログイン後、[データを追加して開始] ページが表示されます。 [データを追加して開始] ページで、[自分で探索する] を選択します。
• [テナントの選択] ページで、[プライベート] ラジオ ボタンを選択し、[確認] をクリックします。 BBE イベントの収集と視覚化ダッシュボードが表示されます。
• プルダウン メニュー (ダッシュボード ウィンドウの左上にある 3 本の水平線) から、[管理] > [ダッシュボード管理] を選択します。 [ダッシュボード管理] ページが表示されます。
• [ダッシュボード管理] ページで、[インデックス パターン] を選択します。 [インデックス パターン] ページが表示されます。
• [インデックス パターン] ページで、ページの右側にある [インデックス パターンの作成] ボタンをクリックします。
• 「ステップ 1: インデックス パターンの定義」ページで、「インデックス パターン名」ボックスに文字列 logstash-bbe-ecav* を入力し、「次のステップ」ボタンをクリックします。

注記： アスタリスク (*) ワイルドカードを使用すると、複数日のインデックス パターンを照合できます。

• 「ステップ 2: 設定の構成」ページで、「@timest」を選択します。amp [時間フィールド] プルダウン ボックスにチェックを入れ、[インデックス パターンの作成] ボタンをクリックします。
• プルダウン メニューを使用して、Discover ページに戻ります。 BBE アプリケーションに対して生成されたすべてのログが表示されます。

注記： 一致するインデックスが少なくとも XNUMX つある場合にのみ、インデックス パターンを作成できます。

時間範囲を変更する方法

「Discover」ページに表示する情報の時間範囲を変更できます。 「Discover」ページには、ログ情報が表示されます。

表示されるイベント情報の時間範囲を変更するには:

1. BBE Event Collection and Visualization ダッシュボードで「Discover」をクリックすると、「Discover」ページが表示されます。
2. 「Discover」ページで、ページの右上にあるカレンダー・アイコンをクリックします。 [時間範囲] セレクター ボックスが表示されます。
3. [時間範囲セレクター] ボックスで、情報を表示する時間範囲を選択し、[適用] をクリックします。選択した時間範囲の情報が「検出」ページに表示されます。

イベント出力をカスタマイズする方法
「Discover」ページに表示する情報をカスタマイズできます。 「Discover」ページには、ログ情報が表示されます。イベント出力をカスタマイズするには:

1. BBE Event Collection and Visualization ダッシュボードで「Discover」をクリックすると、「Discover」ページが表示されます。
2. 「検出」ページの左側の「使用可能なフィールド」フィールドの下に、使用可能なすべてのフィールドがリストされます。
3. 「検出」ページに情報を表示するには、追加するフィールドの横にあるプラス アイコンをクリックします。

フィールドは、フィールドの対応する情報とともに [検出] ページに追加されます。

注記： まずは次のフィールドを追加することをお勧めします。

• 時間
• ホスト。ホスト名
•  プロセス。名前
• メッセージ

レポートの作成方法

「Discover」ページに表示される情報を保存してダウンロードできます。 「Discover」ページには、ログ情報が表示されます。
レポートを作成するには：

1. BBE Event Collection and Visualization ダッシュボードで「Discover」をクリックすると、「Discover」ページが表示されます。
2. 「Discover」ページで、トップメニューにある「Save」をクリックします。 [検索の保存] ダイアログ ボックスが表示されます。
3. 「タイトル」フィールドに、保存した検索の名前を入力し、「保存」をクリックします。保存された検索の名前が [Discover] ページ (左上) に表示されます。
4. 検索が保存されたら、トップ メニューで [レポート] をクリックします。 [生成とダウンロード] ダイアログ ボックスが表示されます。
5. 「CSVの生成」を選択します。レポートは CSV としてダウンロードされます file.

方法 検索する Events Using DQL Search
BBE Event Collection and Visualization ダッシュボードでは、ダッシュボード クエリ言語 (DQL) を使用してイベントを検索できます。ワイルドカードを使用し、フィルターを作成して特定のイベント情報を検索できます。
DQL の使用に関する詳細については、OpenSearch のドキュメントを参照してください。 https://opensearch.org/docs/2.9/dashboards/discover/dql/.

DQL 検索を使用してイベント情報を検索するには、次の手順を実行します。

1. BBE Event Collection and Visualization ダッシュボードで「Discover」をクリックすると、「Discover」ページが表示されます。
2. [Discover] ページで、[DQL Search] フィールド (ページの左上にあります) に探している情報を入力します。検索フィールドで DQL が選択されていることを確認してください。
3. 必要に応じて、探している情報の検索に使用するフィルターを作成することもできます。 「フィルターの追加」を選択します。 [フィルタの編集]ダイアログ ボックスが表示されます。
4. [フィルターの編集] ダイアログ ボックスを使用してフィルターをカスタマイズし、[保存] をクリックします。 Discover ページには、DQL 検索に従って情報が表示されます。

ブロードバンド エッジ イベント収集および視覚化ユーティリティ コマンドの使用方法

まとめ
Broadband Edge Event Collection and Visualization をインストールすると、さまざまな管理機能を実行できるようになります。

ブロードバンド エッジ イベント収集および視覚化ユーティリティ コマンドへのアクセス

Broadband Edge Event Collection and Visualization ユーティリティ スクリプト (ecav) を使用して、アプリケーションを管理し、操作の構成に使用する CLI にアクセスできます。ブロードバンドエッジイベント
Collection and Visualization をインストールすると、ユーティリティ スクリプトが /usr/local/bin に配置されます。
ecav ユーティリティ スクリプトは、ブロードバンド エッジ イベントの収集と視覚化を管理するために必要なタスクを実行しますが、kubectl コマンドの複雑さはマスクされます。この kubectl コマンドのマスキングにより、管理業務が簡素化されます。
ecav ユーティリティ スクリプトは、Kubernetes kubectl ユーティリティ コマンドを使用して次のことを実行します。

• オブジェクトを作成および削除します。
• ログへのアクセスを提供します。
• ポッドコンテナを使用して対話型セッションを実行します。
• ブロードバンド エッジ イベント コレクションおよび視覚化オブジェクトのステータスを表示します。

1 ページの表 12 に、ecav ユーティリティ スクリプトで呼び出すことができるコマンドをリストし、その説明を示します。
各コマンドが開始するアクション。
表 1: ブロードバンド エッジ イベント収集および視覚化ユーティリティのスクリプト コマンド

コマンド名	アクション
ecav clean [–release リリース番号][–docker] [–dry-run][–uninstall]	未使用のソフトウェア リリースを削除し、それを使用してアプリケーションをアンインストールできます。このコマンドには次のオプションがあります。 • リリース 番号—クリーンアップ（削除）したいリリース番号。デフォルトでは、未使用のリリースが削除されます。希望のリリース番号を指定します。   • docker - ローカルの docker キャッシュを消去します。   • dry-run - コマンドによって削除されるリリースまたはコンテナをリストします。   • アンインストール - すべてのソフトウェア リリースをアンインストールし、BBE Edge Event Collection and Visualization をシステムから削除します。
sudo -E はクラスター - 名前変更 -context を実行できます コンテキスト名 -新しい名前 新しい名前	Broadband Edge Event Collection and Visualization が接続されているクラスターの名前を変更します。クラスターの名前を変更しても、Broadband Edge Event Collection and Visualization サービスには影響しません。このコマンドを実行するには、sudo root 権限が必要です。 このコマンドには次のオプションがあります。   • コンテクスト コンテキスト名- 名前を変更する古い Kubernetes クラスター名。クラスターの名前を指定します。   • 新しい名前 新しい名前- Kubernetes クラスターの新しい名前。新しい名前を指定します。
av ip –コンテキスト コンテキスト名 [-o| — 出力 json] [–detail]	外部 IP アドレスを持つすべてのサービスの IP アドレスを表示します。このコマンドには次のオプションがあります。 • コンテクスト コンテキスト名- Kubernetes クラスター名。クラスターの名前を指定します。   • [JSON の出力] - JSON 形式での出力をリクエストできます。   • 詳細 - 詳細な IP 情報を表示します。

コマンド名	アクション
sudo -E はリンクできます — バージョン ソフトウェアリリース -コンテクスト コンテキスト名	クラスターを特定のソフトウェア バージョンにリンクします。このコマンドを実行するには、sudo root 権限が必要です。 このコマンドには次のオプションがあります。   • バージョン ソフトウェアリリース- クラスター固有のリポジ​​トリにリンクするソフトウェア リリースを指定します。   • コンテクスト コンテキスト名- ソフトウェア リリースにリンクする Kubernetes クラスター名。クラスターの名前を指定します。
sudo -E はロールアウトできる — コンテキスト コンテキスト名 - バージョン ソフトウェアリリース]	ブロードバンド エッジ イベントの収集および視覚化サービスをアップグレードします。このコマンドを実行するには、sudo root 権限が必要です。 このコマンドには次のオプションがあります。   • コンテクスト コンテキスト名- 新しいソフトウェア バージョンをロールアウトする Kubernetes クラスターの名前。クラスターの名前を指定します。   • バージョン ソフトウェアリリース—ロールアウトされるソフトウェア リリース。ソフトウェアのリリース番号を指定します。
sudo -E でセットアップできる — コンテキスト コンテキスト名 [-デフォルト] [-更新]	インストール プロセスの一部として、Broadband Edge Event Collection and Visualization アプリケーションをセットアップします。このコマンドを実行するには、sudo root 権限が必要です。 このコマンドには次のオプションがあります。   • コンテクスト コンテキスト名- 起動を実行する Kubernetes クラスター名。クラスターの名前を指定します。   • デフォルト - セットアップでは、BBE Cloudsetup がクラスターを作成したときに入力されたデフォルト値が使用されます。   • 更新 - セットアップ中に欠落している値の入力のみを求められます。

コマンド名	アクション
sudo -E で開始できる — コンテキスト コンテキスト名	特定のブロードバンド エッジ イベントの収集および視覚化サービスを開始します。このコマンドを実行するには、sudo root 権限が必要です。 このコマンドには次のオプションがあります。   • コンテクスト コンテキスト名- ブロードバンド エッジ イベントの収集と視覚化を開始する Kubernetes クラスターの名前。クラスターの名前を指定します。
ecav ステータス - コンテキスト コンテキスト名 [-o|–出力 json]	ブロードバンド エッジ イベント収集および視覚化サービスの現在のステータスを表示します。 このコマンドには次のオプションがあります。   • コンテクスト コンテキスト名- Kubernetes クラスター名。クラスターの名前を指定します。   • 出力 - JSON 形式での出力をリクエストできます。
sudo -E は停止できる — コンテキスト コンテキスト名 -今	すべてのブロードバンド エッジ イベント収集および視覚化サービスを停止します。このコマンドを実行するには、sudo root 権限が必要です。 このコマンドには次のオプションがあります。   • コンテクスト コンテキスト名- ブロードバンド エッジ イベントの収集と視覚化を停止する Kubernetes クラスターの名前。クラスターの名前を指定します。   • now - このオプションのコマンドが入力されない場合、停止は XNUMX 分後に開始されます。
sudo -E でリンクを解除できる — コンテキスト コンテキスト名	クラスターに関連付けられたコンポーネントのリンクを解除します。このコマンドを実行するには、sudo root 権限が必要です。 このコマンドには次のオプションがあります。   • コンテクスト コンテキスト名- アンインストールする Kubernetes クラスター名。クラスターの名前を指定します。

コマンド名	アクション
av バージョン [–context コンテキスト名] [-o|– 出力 json] [–detail]	以下のバージョンを表示します。   • Broadband Edge Event Collection and Visualization インスタンスで実行されているすべてのマイクロサービス。   • ブロードバンド エッジ イベントの収集および視覚化ユーティリティ。   • システム上で利用可能なすべてのブロードバンド エッジ イベント収集および視覚化ソフトウェア リリース。   このコマンドには次のオプションがあります。   • コンテクスト コンテキスト名- Kubernetes クラスター名。クラスターの名前を指定します。   • 出力 - JSON 形式での出力をリクエストできます。   • 詳細 - 利用可能なすべてのソフトウェア バージョンを表示します。

コマンドを発行するには、次の一般的な構文を使用します。

• 短いオプションの場合:

• 長いオプションの場合:

• 使用可能なコマンドのリストと簡単な説明を表示するには、 h または help オプションを使用します。

• 特定のコマンドのオプションを表示するには:

ブロードバンド エッジ イベント収集および視覚化サービスを開始する

• ローカル ユーティリティ スクリプトを使用して、すべての BBE イベント収集および視覚化サービスを開始します。
• 次のコマンドを実行して、すべての BBE イベント収集および視覚化サービスを開始します。

注記： BBE イベント収集および視覚化サービスを停止することはお勧めしません。

ブロードバンド エッジ イベント収集および視覚化サービスのステータスを確認する

• ecav status ユーティリティ スクリプトを使用して、BBE Event Collection and Visualization サービスのステータスを確認します。ステータスは、サービスが実行中かどうかを示します。
• サービスに関する詳細情報を確認するには、次のコマンドを実行します。

例えばample

ブロードバンド エッジ イベントの収集と視覚化のアンインストールと削除
ecav ユーティリティ スクリプトを使用して、BBE Event Collection and Visualization 構成をアンインストールします。 clean コマンドは、BBE Event Collection および Visualization のすべてのバージョンをシステムからアンインストールし、削除します。
BBE Event Collection and Visualization をアンインストールするには:

1. BBE Event Collection and Visualization をインストールしたジャンプ ホストで、stop コマンドを実行します。
2. リンク解除コマンドを実行します。
3. クリーンコマンドを実行します。

接触

• ジュニパーネットワークス株式会社
• 1133イノベーションウェイ
• カリフォルニア州サニーベール94089
• アメリカ合衆国
• 408-745-2000
• www.juniper.net

Juniper Networks、Juniper Networks のロゴ、Juniper、および Junos は、Juniper Networks, Inc. の登録商標です。
米国およびその他の国で。 その他すべての商標、サービス マーク、登録商標、または登録サービス マークは、それぞれの所有者の財産です。
Juniper Networks は、このドキュメントの誤りについて一切の責任を負いません。 Juniper Networks は、予告なしにこの出版物を変更、修正、譲渡、またはその他の方法で改訂する権利を留保します。
ブロードバンド エッジ イベントの収集および視覚化インストール ガイド Copyright © 2023 Juniper Networks, Inc. 全著作権所有。
このドキュメントの情報は、タイトル ページの日付現在のものです。

西暦2000年の通知
ジュニパーネットワークスのハードウェアおよびソフトウェア製品は、2000 年問題に準拠しています。 Junos OS には、2038 年までの既知の時間関連の制限はありません。ただし、NTP アプリケーションには、2036 年に問題があることが知られています。

エンドユーザーライセンス契約
この技術文書の主題である Juniper Networks 製品は、Juniper Networks ソフトウェアで構成されています (または、Juniper Networks ソフトウェアでの使用を意図しています)。 そのようなソフトウェアの使用は、次の Web サイトに掲載されているエンド ユーザー ライセンス契約 (「EULA」) の条件に従うものとします。 https://support.juniper.net/support/eula/。 かかるソフトウェアをダウンロード、インストール、または使用すると、その EULA の利用規約に同意したものとみなされます。

ドキュメント / リソース

Juniper NETWORKS ブロードバンド エッジ イベントの収集と視覚化 [pdf] ユーザーガイド ブロードバンドエッジイベント収集と可視化、ブロードバンドエッジ、イベント収集と可視化、収集と可視化

参考文献

• ユーザーマニュアル