内容

はじめに

前提条件

要件

背景説明

設定

確認

はじめに

このドキュメントでは、Secure Malware Analytics Appliance(SMA)サービスメトリックデータをPrometheusモニタリングソフトウェアにエクスポートする手順について説明します。

著者：Cisco TAC エンジニア

前提条件

Secure Malware Analytics ApplianceおよびPrometheusソフトウェアに関する知識があることが推奨されます。

要件

- Secure Malware Analyticsアプライアンス（バージョン2.13以降）

- Prometheusソフトウェアライセンス

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。対象のネットワークが実稼働中である場合には、どのようなコマンドについても、その潜在的な影響について確実に理解しておく必要があります。

背景説明

TApplianceで実行されているRiemann/Elastic検索ベースの監視システムは、Secure Malware Analytics Applianceバージョン2.13以降のPrometheusベースの監視に置き換えられました。

注：この統合の主な目的は、Prometheus Monitoring Systemソフトウェアを使用してSecure Malware Analyticsアプライアンスの統計情報を監視することです。これには、インターフェイス、トラフィック統計情報などが含まれます。

設定

ステップ 1：Secure Malware Analytics Applianceにログインし、[Operations] > [Metrics]に移動して、APIキーと基本認証パスワードを見つけます。

ステップ 2：Prometheus Serverソフトウェアのインストール：https://prometheus.io/download/

ステップ 3： .ymlファイルを作成します。このファイルはprometheus.ymlと呼ばれ、次の詳細が含まれている必要があります。

scrape_configs:

- job_name: 'metrics'

bearer_token_file: 'token.jwt'

scheme: https

file_sd_configs:

- files:

- 'targets.json'

relabel_configs:

- source_labels: [__address__]

regex: '[^/]+(/.*)'                             # capture '/...' part

target_label: __metrics_path__                  # change metrics path

- source_labels: [__address__]

regex: '([^/]+)/.*'                             # capture host:port

target_label: __address__                       # change target

ステップ 4：CLIコマンドを実行して、認証用のJWTトークンを生成します（上記のコンフィギュレーションファイルで指定されています）。

curl -k -s -XPOST -d 'user=threatgrid&password=<TGA Password>&method=password' "https://_opadmin IP_:443/auth?method=password" | tee token.jwt

ステップ 5：このコマンドを実行して、トークンのExpiration Dateフィールド（1時間の有効期間）を確認します。

awk -F. '{print $2}' token.jwt | base64 --decode 2>/dev/null | sed -e 's;\([^}]\)$;\1};' | jq .

次のコマンド出力例を参照してください。

{

"user": "threatgrid",

"pw_method": "password",

"addr": "

",

"exp": 1604098219,

"iat": 1604094619,

"iss": "

",

"nbf": 1604094619

}

注：時間はエポック形式で表示されます。

手順 6：サービスの設定を取得し、opadminインターフェイスにログインした後、UIから次の行を入力します。

https://_opadmin IP_/metrics/v1/config

手順 7：Prometheusサービスを再起動すると、構成がアクティブ化されます。

ステップ 8：Prometheusページにアクセスします。

http://localhost:9090/graph

図に示すように、Secure Malware Analyticsアプライアンスサービスが「UP」状態であることが確認できます。

確認

Secure Malware Analyticsアプリケーションデバイスからデータを受信し、図に示すように、独自の要件に基づいてメトリックを確認できます。

注：この機能は、特定のデータを収集する場合にのみ機能します。データフロー管理はPrometheusサーバーの責任です。

Cisco TAC側でサポートされているトラブルシューティングはありません。サードパーティベンダーのサポートに連絡して、追加の機能サポートを受けることができます。