SNMPの設定
アプライアンスでSNMPを有効にして、既存のネットワーク管理システムからアプライアンスを監視してください。アプライアンスにSNMPエージェントを設定し、SNMPマネージャーがアプライアンスをポーリングして、使うv2cやv3クエリの状況を取得できます。 サポートされているOIDの詳細については、 「標準OID」および「カスタムOID」を参照してください。
アプライアンス上でSNMPトラップが設定されている場合、アプライアンスはネットワーク内のトラップ受信機にトラップ通知を送信することもできます。
前提条件
アプライアンスが SNMP クエリへの応答を開始する前に、次の設定を行う必要があります。
- sshを使ってアプライアンスコンソールにアクセスします。
- ログインして
nsadmin/nsapplianceクレデンシャルを使います。 nsshellが開きます。 - nsshellの設定モードに入るには、
configureを入力してください。 - SNMPエージェントを設定します。SNMPエージェントの設定を参照してください。
- SNMPトラップを設定します。SNMPトラップの設定を参照してください。
SNMPエージェントの設定
アプライアンスがSNMPマネージャからのSNMPクエリに応答するように、SNMPエージェントを設定します。以下のコマンドを実行してください。
set snmp agent enable true set snmp agent syscontact <email address> set snmp agent syslocation <location>
アプライアンスを使う v2c クエリをポーリングするには、次を実行します。
set snmp agent v2c rocommunity-string <string value> add snmp agent v2c allowed-network-list set snmp agent v2c allowed-network-list 0 network <IP address of the SNMP agent> save
アプライアンスを使う v3 クエリをポーリングするには、次を実行します。
set snmp agent v3 engine-id <engine-id> set snmp agent v3 usm auth username <username> key <passphrase> protocol [MD5|SHA] set snmp agent v3 usm privacy protocol [AES|DES] key <passphrase> save
コマンドデスクリプションは次のとおりです。
| CLIコマンド | デスクリプション | ||
|---|---|---|---|
set snmp agent | enable | アプライアンス上のSNMPエージェントを有効/無効にします。trueに設定すると、アプライアンスは v2c または v3 エージェントとして構成する必要があります。 | |
syscontact | システムのコンタクト情報（管理者メールなど）を設定します。 例えば、admin@localskope.local などです。 | ||
syslocation | システムの場所を設定します。例えば、「ロスアルトス本社」など。 | ||
v2c rocommunity-string | 文字列値を指定してください。ここで設定された文字列は SNMPマネージャからのsnmpwalk / snmpgetコマンドで、公開された情報にアクセスするために使用されます。 値が設定値と一致しない場合、関連情報は返されません。SNMPv2におけるアクセス制御として使われます。 | ||
v2c allowed-network-list | (Optional) ホスト/サブネットのリストを提供してください。 | ||
v3 engine-id | (Optional) SNMPエージェントのエンジン識別子を16進数形式で設定してください。例えば、0x0102030405。 | ||
v3 usm auth | username | SNMPエージェントでユーザーを認証するためのユーザー名を設定します。 | |
key | SNMPエージェントに接続するために必要なパスワードを設定してください。 | ||
protocol | アプライアンス上のSNMPエージェントとSNMPマネージャ間でやり取りされるデータを保存するために、「MD5」または「SHA」のいずれかのハッシュ関数を選択してください。 | ||
v3 usm privacy | protocol | (Optional) アプライアンス上の SNMP エージェントと SNMP マネージャー間のトラフィックを暗号化するには、暗号化の種類「AES」または「DES」を選択します。 | |
key | (Optional) SNMPエージェント上の暗号化されたデータにアクセスするために必要なパスワードを設定してください。 | ||
SNMPトラップの設定
アプライアンス上でSNMPトラップを設定し、SNMPトラップ受信側にトラップ通知を送信するようにします。以下のコマンドを実行してください。
set snmp traps server <hostname or IP address>
SNMP v2cトラップをトラップ受信機に送信するには、以下を実行します。
set snmp traps v2c enable true save
SNMP v3トラップをトラップ受信機に送信するには、以下を実行します。
set snmp traps v3 enable true set snmp traps v3 use-agent-settings [true|false] set snmp traps v3 engine-id <engine-id> set snmp traps v3 usm auth username <username> key <passphrase> protocol [MD5|SHA] set snmp traps v3 usm privacy protocol [AES|DES] key <passphrase> save
コマンドデスクリプションは次のとおりです。
| CLIコマンド | デスクリプション | ||
|---|---|---|---|
set snmp traps | server | アプライアンスがv2cまたはv3トラップを送信できるように、SNMPトラップ受信機のホスト名またはIPアドレスを指定してください。 | |
v2c enable | trueに設定すると、アプライアンスは v2c トラップ通知をトラップ受信機に送信します。 | ||
v3 | enable | trueに設定すると、アプライアンスは v3 トラップ通知をトラップ受信機に送信します。 | |
use-agent-settings | 同じv3 USM認証とプライバシー設定を使用したい場合は、 trueに設定してください。 SNMPエージェントと同じv3 USM認証とプライバシー設定を使用します。 それ以外の場合は、アプライアンス上のトラップクライアントに対してv3 USM認証とプライバシーを設定してください。 | ||
engine-id | トラップクライアントのエンジン識別子を設定します。use-agent-settingsが設定されていない場合は、これが必須です。 | ||
v3 usm auth | username | トラップクライアントでユーザーを認証するためのユーザー名を設定します。 | |
key | (Optional) トラップクライアントへの接続に必要なパスワードを設定してください。 | ||
protocol | アプライアンス上のトラップクライアントとトラップレシーバー間でやり取りされるデータを保存するために、「MD5」または「SHA」のいずれかのハッシュ関数を選択してください。 | ||
v3 usm privacy | protocol | (Optional) アプライアンスのトラップ クライアントとトラップ レシーバ間のトラフィックを暗号化するには、暗号化の種類「AES」または「DES」を選択します。 | |
key | (Optional) 暗号化データにアクセスするために必要なパスワードをアプライアンスに設定します。 | ||
標準OID
これらは標準的なOIDです。
| OID | デスクリプション | Values |
|---|---|---|
SNMPv2-MIB::sysDescr | 標準システムデスクリプション。 | STRING: Linux lcsnmp 4.4.0-21-generic #37-Ubuntu SMP Mon Apr 18 18:33:37 UTC 2016 x86_64 |
DISMAN-EVENT-MIB::sysUpTimeInstance | SNMPエージェントが起動してからのティック数。 | タイムティック: (2515) 0:00:25.15 |
SNMPv2-MIB::sysName | これにはホスト名を使用できます。 デフォルトでは、SNMPエージェントはホスト名を取得します。 | CLIによって設定されたホスト名（ set system hostname ）。 |
SNMPv2-MIB::sysContact | Standard SNMP configuration parameter. | CLIで設定： set snmp agent syscontact |
SNMPv2-MIB::sysLocation | Standard SNMP configuration parameter. | CLIで設定： set snmp agent syslocation |
SNMPv2-MIB::sysObjectID | Standard SNMP configuration parameter. | OID: NET-SNMP-MIB::netSnmpAgentOIDs.10 |
HOST-RESOURCES-MIB::hrSystemUptime | Actual system up time. | タイムティックス: (381446115) 44日、3時間34分21秒15 |
UCD-SNMP-MIB::systemStats | システム全体の統計情報。 | CLIコマンド: snmpwalk -v 2c -c appliancecom172.18.78.228UCD-SNMP- MIB::systemStats |
UCD-SNMP-MIB::memory | メモリ使用量統計。 | CLIコマンド: snmpwalk -v 2c -c appliancecom172.18.78.228UCD-SNMP- MIB::memory |
UCD-SNMP-MIB::laTable | CPU負荷平均情報。 | CLIコマンド: snmpwalk -v 2c -c appliancecom 10.136.127.239 UCD-SNMP-MIB::laTable |
UCD-SNMP-MIB::dskTable | ディスク監視情報。 | CLIコマンド: snmpwalk -v 2c -c appliancecom 10.136.127.239 UCD-SNMP-MIB::dskTable |
IF-MIB::interfaces | インターフェース情報。 | CLIコマンド: snmpwalk -v 2c -c appliancecom 10.136.127.239 IF-MIB::interfaces |
カスタムOID
Netskope に IANA (http://www.iana.org/) から割り当てられた公式の民間企業番号 (PEN)割り当て/企業番号) は 48007 です。
| OID | デスクリプション | Values |
|---|---|---|
enabledServices | この機器で有効になっているさまざまなサービス。例えば、管理プレーン、OPLP、フォワーダーなど。 | 可能な値は、 Management-Plane 、 Tap 、 Forwarder 、 Forward-Proxy 、 DNS-Proxy 、 PAC-Server 、 Log-Processing 、 OPLP 、 Databaseです。サンプル出力: [DNS-Proxy,PAC-Server,OPLP] |
dataplaneStatus | DPの健全性チェックをミラーリングしています。configure> set dataplane healthcheck enable true 。 | 整数値は、 1 = 上、 2 = 下、 3 = 不明です。 |
managementplaneStatus | アプライアンスが管理プレーンに接続されているかどうか。接続されている場合、管理プレーンを通じて詳細な監視ステータスを確認できます。 | 整数値は、 1 = 上、 2 = 下、 3 = 不明です。 |
lastConnectedToMP | 前回、国会議員との接続が成功したのはいつだったか。 | 文字列を日時として取得します。例えば： "Thu, 02 Jun 2016 21:28:27" |
deviceStatus | アプライアンスの健康状態を表します（監視フレームワークによって報告される）。 デバイスが管理プレーンアプライアンスである場合、そのステータスは、Zookeeper、Kafka、Mongoなどのサービスの健全性を表します。 デバイスが管理プレーンアプライアンスでない場合、それはログ管理、またはそのモードに関連するその他のサービスの状態を表します。 | 整数値は次のとおりです: 1 = 良好、 2 = 不良3 = 不明 |
oplpStatus | オンプレミスログパーサー（OPLP）のステータス。 | 整数値は、 1 = 上、 2 = 下です。 |
dpopStatus | データプレーンオンプレミスアプライアンス（DPoP）のステータス。 | 整数値は、 1 = 上、 2 = 下です。 |
haState | 高可用性（HA）の状態。 結果はCLI（ show dataplane ha environment ）と同じです。 | 整数値は次のとおりです: 1 = マスター、 2 = バックアップ、 3 = 障害、 4 = 不明 |
SNMPトラップ
アプライアンスからSNMPトラップ通知を受信するために、SNMPサーバー上にSNMPトラップ受信機を設定してください。アプライアンスは、次の SNMP トラップ通知 OID を使用します。
| OID | デスクリプション | Values |
|---|---|---|
mpConnectionNotif | 管理プレーンの接続状態が変化するたびに、トラップサーバーに通知が送信されます。 | 該当なし |
deviceStatusNotif | デバイスの状態が変化するたびに、トラップサーバーに通知が送信されます。 | 該当なし |
cpuUsageNotif | CPU使用率が90%を超えると、トラップサーバーに通知が送信されます。 | 整数値は、 1 = 通常、 2 = 高 です。 |
SNMPトラップ（ snmptrapd ）を受信するデーモンが実行されていることを確認してください。
トラップ受信機を設定するには、
- SNMPサーバー上で、使うしたいディレクトリを作業ディレクトリに行ってください。 例えば、
cd /Users/snmpuser/。 snmptrapd(snmptrapd.conf) 用の設定ファイルを作成します。このファイルには1行だけ記述します。cat snmptrapd.conf disableAuthorization yes
snmptrapdを開始します。sudo snmptrapd -f -Lo -c snmptrapd.conf
- このシステムの IP アドレスをメモします。これは、トラップの送信元となるアプライアンスから到達可能である必要があります。
- アプライアンスでは、そのIPアドレスを
snmp traps serverとして設定し、SNMPが有効になっていることを確認してください。set snmp traps server <hostname or IP address>
- 管理プレーンの接続状態が変化すると、SNMPサーバーに次のような通知が表示されます。
2016-09-29 18:19:24 <UNKNOWN> [UDP: [192.168.64.36]:55034->[0.0.0.0]:0]: DISMAN-EVENT-MIB::sysUpTimeInstance = Timeticks: (28067711) 3 days, 5:57:57.11 SNMPv2-MIB::snmpTrapOID.0 = OID: SNMPv2-SMI::enterprises.48007.5 SNMPv2-SMI::enterprises.48007.5.1 = INTEGER: 0
INTEGER:後の値は0であり、これは管理プレーン接続の現在の状態を反映していることに注意してください。詳細なデスクリプションについては、カスタム OID テーブルのmanagementplaneStatusを参照してください。