コンテンツにスキップ

QoSエージェント管理ダッシュボード

QoSエージェントを監視、設定、管理するための直感的なインターフェースを提供するWebベースの管理ダッシュボード。

Dashboard

概要

QoSエージェント管理ダッシュボードでは、次のことができます：

  • QoSエージェントを実行しているDockerコンテナの監視と管理
  • リアルタイムのコンテナログとシステムステータスの表示
  • Webインターフェースを通じたエージェント設定の編集と検証
  • ネットワーク情報と接続ステータスへのアクセス
  • システム概要と健全性チェックの実行

QoSエージェント管理ダッシュボードは、エージェントを実行しているVMにインストールする必要があります

クイックスタート

インストール

すべての依存関係とセットアップを処理する自動インストールスクリプトを提供しています：

1) インストールスクリプトをここからダウンロード：

wget https://api.latence.ca/software/agent-mgmt-install.sh

2) スクリプトを実行

sudo bash agent-mgmt-install.sh

インストールスクリプトは次のことを行います：

  • 必要なシステム依存関係（Pythonなど）をインストール
  • 管理システムをダウンロードしてセットアップ
  • Webインターフェースとバックエンドサービスを設定して起動
  • 自動起動用のsystemdサービスをセットアップ

ダッシュボードへのアクセス

インストール後、次のURLでWebダッシュボードにアクセスします：

http://your-server-ip:12022

ダッシュボードの機能

Docker管理

  • 起動/停止/再起動：QoSエージェントコンテナを制御
  • 更新：最新のコンテナイメージをプルしてサービスを再起動
  • コンテナのリスト表示：すべての実行中および停止中のコンテナを表示

コンテナログ

  • 任意のコンテナからのリアルタイムログを表示
  • ログエントリの検索とフィルタリング
  • エージェントのパフォーマンスを監視し、問題をトラブルシューティング

ネットワーク情報

  • システムのネットワーク設定を表示
  • ネットワークインターフェースと接続ステータスを表示
  • ネットワークの健全性を監視

エージェント設定エディタ

  • Webインターフェースを通じたQoSエージェント設定の編集
  • YAML検証：リアルタイムの構文と構造の検証
  • 接続テスト：リフレクターとmsgbusの接続の自動検証
  • 設定のバックアップ：設定バージョンの保存と復元

システム概要

  • リアルタイムのシステムステータス監視
  • リソース使用情報
  • サービスの健全性チェック

設定管理

エージェント設定ファイル

システムは、次を定義するlti_qos-agent.yml設定ファイルを管理します：

  • QoSエージェントDockerコンテナ設定
  • ネットワーク設定と機能
  • 環境変数（エージェントID、ライセンスキー、リフレクター）
  • ログと再起動ポリシー

検証機能

組み込みのバリデーターは次をチェックします：

  • YAMLの構文と構造
  • 必須のDocker Composeフィールド
  • リフレクターとメッセージバスへのネットワーク接続
  • エージェントIDの一意性
  • GPS座標とIPアドレスの形式
  • 環境変数の完全性

一般的な操作

QoSエージェントの起動

  1. http://your-server-ip:12022でダッシュボードにアクセス
  2. Docker管理に移動
  3. 起動をクリックしてQoSエージェントコンテナを起動
  4. コンテナログで起動を監視

エージェント設定の更新

  1. QoSエージェント設定エディタに移動
  2. 設定をロードをクリックして現在の設定を表示
  3. エディタで変更を行う
  4. YAMLを検証をクリックしてエラーをチェック
  5. 設定を保存をクリックして変更を適用
  6. 新しい設定を適用するためにコンテナを再起動

ログの表示

  1. コンテナログに移動
  2. コンテナIDを入力するか、コンテナのリスト表示を使用して見つける
  3. ログを取得をクリックして最近のアクティビティを表示
  4. エラーまたはパフォーマンスの問題を監視

システム監視

  1. システム概要で全般的な健全性を確認
  2. ネットワーク情報を使用して接続を確認
  3. コンテナログで進行中の操作を監視

トラブルシューティング

一般的な問題

起動、停止、再起動、更新コマンドが機能しない：

  • スクリプトはdockerバージョン2を使用
  • したがってdocker composeを使用し、docker-composeではありません
  • docker-composeを使用している場合は、scripts/ディレクトリに移動して、スクリプトを変更してバージョンを使用できます

ダッシュボードにアクセスできない：

  • ファイアウォールでポート12022が開いていることを確認
  • systemctl statusでサービスが実行されていることを確認

設定検証エラー：

  • YAML構文が正しいことを確認
  • すべての必須フィールドが存在することを確認
  • リフレクターへのネットワーク接続を確認

コンテナの起動失敗：

  • エラーメッセージについてコンテナログを確認
  • Dockerが実行されていることを確認：sudo systemctl status docker
  • 設定ファイルの権限を確認

サービスステータス

サービスが実行されているか確認：

sudo systemctl status grpc-server.service
sudo systemctl status grpc-ui.service

サービスログの表示

sudo journalctl -u grpc-server.service -f
sudo journalctl -u grpc-ui.service -f

サービスの再起動

sudo systemctl restart grpc-server.service
sudo systemctl restart grpc-ui.service

アンインストール

作成されたすべてのサービスとエージェント管理ディレクトリを削除するアンインストールスクリプトも提供しています：

1) アンインストールスクリプトをここからダウンロード：

wget https://api.latence.ca/software/agent-mgmt-uninstall.sh

2) スクリプトを実行

sudo bash agent-mgmt-uninstall.sh

これにより次が削除されます：

  • gRPCサーバーとWeb UIサービス
  • プロジェクトディレクトリ
  • /usr/local/bin/からのgrpcurl
  • すべての関連systemdサービス

セキュリティに関する注意事項

  • ダッシュボードはデフォルトでポート12022で実行されます
  • 環境に適したファイアウォール設定を確保してください
  • 定期的な設定のバックアップが推奨されます
  • 異常なアクティビティについてシステムログを監視してください