ネットワーク監視の高度な構成

例：

discovery:
  default_v3:
    user_name: test1
    authentication_protocol: MD5
    authentication_passphrase: authPass1
    privacy_protocol: AES256
    privacy_passphrase: privacyPass1
    context_engine_id: ""
    context_name: ""

AWS シークレットを使用して認証情報を渡すため。次のように SNMPv3 構成スニペットを更新し、 $SECRET_NAMEの前にaws.sm.を付けます。

default_v3: aws.sm.$SECRET_NAME

AWS では、関連するすべてのkey:valueペアとともにシークレットを JSON 形式で保存する必要があります。これは例です:

{
  "user_name": "$YOUR_USER_NAME",
  "authentication_protocol": "$YOUR_AUTHENTICATION_PROTOCOL",
  "authentication_passphrase": "$YOUR_AUTHENTICATION_PASSPHRASE",
  "privacy_protocol": "$YOUR_PRIVACY_PROTOCOL",
  "privacy_passphrase": "$YOUR_PRIVACY_PASSPHRASE"
}

複数のSNMPv3プロファイルでの検出ジョブの実行をサポートするために、 discovery.default_v3キーをSNMPv3構成の配列を保持するdiscovery.other_v3sキーに置き換えることができます。

discovery:
  other_v3s:
  - user_name: $YOUR_USER_NAME_1
    authentication_protocol: $YOUR_AUTHENTICATION_PROTOCOL_1
    authentication_passphrase: $YOUR_AUTHENTICATION_PASSPHRASE_1
    privacy_protocol: $YOUR_PRIVACY_PROTOCOL_1
    privacy_passphrase: $YOUR_PRIVACY_PASSPHRASE_1
    context_engine_id: ""
    context_name: ""
  - user_name: $YOUR_USER_NAME_2
    authentication_protocol: $YOUR_AUTHENTICATION_PROTOCOL_2
    authentication_passphrase: $YOUR_AUTHENTICATION_PASSPHRASE_2
    privacy_protocol: $YOUR_PRIVACY_PROTOCOL_1
    privacy_passphrase: $YOUR_PRIVACY_PASSPHRASE_2
    context_engine_id: ""
    context_name: ""

Arista eAPI 統合は、通常 SNMP ポーリングでは利用できない追加の BGP および MLAG テレメトリを収集します。

• BGP の詳細は次のコマンドから収集されます。 show ip bgp summary vrf all

  NRQL を使用して BGP テレメトリを検索します。

  FROM Metric SELECT
    max(kentik.eapi.bgp.InMsgQueue) AS 'InQ', // Messages Queued from the Neighbor
    max(kentik.eapi.bgp.MsgReceived) AS 'MsgSent', // Messages Received from the Neighbor
    max(kentik.eapi.bgp.MsgSent) AS 'MsgRcvd', // Messages Sent to the Neighbor
    latest(peer_state) AS 'State', // State of the BGP session
    latest(kentik.eapi.bgp.UpDownTime) AS 'Up/Down', // Period the BGP session has been in current state
    latest(kentik.eapi.bgp.Version) AS 'V' // BGP version number
  FACET
    entity.name AS 'Device',
    router_id AS 'Device IP',
    peer AS 'BGP Peer',
    peer_asn AS 'BGP Peer ASN',
    vrf AS 'VRF Name'

  コピー
  
  

• MLAG の詳細は、次のコマンドから収集されます。 show mlag detail

  NRQL で MLAG テレメトリを検索します。

  FROM Metric SELECT
    latest(kentik.eapi.mlag.PortsConfigured) AS 'Ports Configured', // Count of MLAG ports currently configured
    latest(kentik.eapi.mlag.PortsDisabled) AS 'Ports Disabled', // Count of MLAG ports in 'Disabled' state
    latest(kentik.eapi.mlag.PortsActivePartial) AS 'Ports Active-partial', // Count of MLAG ports in 'Active-partial' state 
    latest(kentik.eapi.mlag.PortsInactive) AS 'Ports Inactive', // Count of MLAG ports in 'Inactive' state
    latest(kentik.eapi.mlag.PortsActiveFull) AS 'Ports Active-full', // Count of MLAG ports in 'Active-full' state
    latest(kentik.eapi.mlag.PortsErrdisabled) AS 'Ports Err-disabled', // Count of MLAG ports in 'Err-disabled' state
    latest(config_sanity) AS 'Config-Sanity', // Current result of 'config-sanity' check
    latest(state) AS 'State', // Current MLAG state
    latest(neg_status) AS 'Negotiation Status', // Current negotiation status between switches
    latest(peer_address) AS 'Peer Address', // Address of MLAG peer
    latest(peer_link) AS 'Peer Link', // Link name for MLAG peer
    latest(peer_link_status) AS 'Peer Link Status', // Status of MLAG peer
    latest(local_interface) AS 'Local Interface', // Local interface used for MLAG configuration
    latest(local_intf_status) AS 'Local Interface Status' // Status of local interface used for MLAG configuration
  FACET
    entity.name AS 'Device',
    domain_id AS 'MLAG Domain ID'

  コピー

  設定オプション

  キー名	必須	説明
  eapi_config.ユーザー名	✓✓	eAPI 認証を認証するためにデバイスに渡すユーザー名。
  eapi_config.パスワード	✓✓	eAPI 認証を認証するためにデバイスに渡すパスワード。
  eapi_config.transport		使用する接続トランスポートのタイプを指定します。可能な値は https と httpです。デフォルト: https 。
  eapi_config.port	✓✓	eAPI 接続のエンドポイントの TCP ポート。

Meraki ダッシュボード API統合は、Meraki 環境の健全性に関連するさまざまなメトリクスを取得します。さまざまな構成オプションを組み合わせることで、ニーズに合わせたさまざまな監視シナリオをセットアップできます。

• meraki_config.monitor_devices: true && meraki_config.preferences.device_status_only: true：組織デバイス ステータスの取得エンドポイントを使用して、組織内のすべての Meraki デバイスのステータスを一覧表示します。

  NRQL を使用してデバイス ステータス テレメトリを検索します。

  FROM Metric SELECT
    latest(status) AS 'Device Status' // Current status of this device
  FACET
    org_id AS 'Organization ID',
    org_name AS 'Organization Name',
    network_id AS 'Network ID',
    network AS 'Network Name',
    device_name AS 'Device Name',
    src_addr AS 'Device Public IP',
    mac AS 'Device MAC',
    model AS 'Device Model',
    serial AS 'Device Serial',
    address AS 'Device Address',
    lat AS 'Device Latitude',
    lng AS 'Device Longitude',
    notes AS 'Device Notes'
  WHERE instrumentation.name = 'meraki.device_status'

  コピー
  
  

• meraki_config.monitor_org_changes: true:組織構成変更の取得エンドポイントを使用して、組織の変更ログを表示します。

  NRQL を使用して組織構成変更テレメトリを検索します。

  FROM KExtEvent SELECT *

  コピー
  
  

• meraki_config.monitor_uplinks: true && meraki_config.preferences.hide_uplink_usage: false：組織のアップリンク ステータスの取得とネットワーク エンドポイントごとの組織アプライアンス アップリンクの使用状況の両方を使用して、組織内のすべての Meraki MX、MG、および Z シリーズ デバイスのアップリンク ステータスとパフォーマンスを一覧表示します。

  NRQL を使用してデバイスのアップリンク テレメトリを検索します。

  FROM Metric SELECT
    max(kentik.meraki.uplinks.LatencyMS) AS 'Uplink Latency', // Uplink measured latency in milliseconds
    max(kentik.meraki.uplinks.LossPct) AS 'Uplink Loss %', // Uplink measured loss percentage
    max(kentik.meraki.uplinks.Recv) AS 'Uplink Receive Bytes', // Uplink bytes received
    max(kentik.meraki.uplinks.Sent) AS 'Uplink Transmit Bytes', // Uplink bytes sent
    latest(status) AS 'Uplink Status' // Latest status of the uplink
  FACET
    org_id AS 'Organization ID',
    org_name AS 'Organization Name',
    network_id AS 'Network ID',
    network AS 'Network Name',
    device_name AS 'Device Name',
    interface AS 'Device Uplink Interface',
    model AS 'Device Model',
    serial AS 'Device Serial'
  WHERE org_id IS NOT NULL

  コピー
  
  

• meraki_config.monitor_uplinks: true && meraki_config.preferences.hide_uplink_usage: true：組織のアップリンク ステータスの取得エンドポイントを使用して、組織内のすべての Meraki MX、MG、および Z シリーズ デバイスのアップリンク ステータスのみを一覧表示します。

  NRQL を使用してデバイスのアップリンク ステータス テレメトリを検索します。

  FROM Metric SELECT
    latest(status) AS 'Uplink Status' // Latest status of the uplink
  FACET
    org_id AS 'Organization ID',
    org_name AS 'Organization Name',
    network_id AS 'Network ID',
    network AS 'Network Name',
    device_name AS 'Device Name',
    interface AS 'Device Uplink Interface',
    model AS 'Device Model',
    serial AS 'Device Serial'
  WHERE org_id IS NOT NULL

  コピー
  
  

• meraki_config.monitor_vpn_status: true && meraki_config.preferences.show_vpn_peers: false:組織アプライアンスの VPN ステータスの取得エンドポイントを使用して、組織内のネットワーク全体の VPN ステータスを表示します。

  NRQL を使用して VPN ステータス テレメトリを検索します。

  FROM Metric SELECT
    latest(status) AS 'VPN Status' // Latest status of this VPN
  FACET
    org_id AS 'Organization ID',
    org_name AS 'Organization Name',
    network_id AS 'Network ID',
    network AS 'Network Name',
    device_name AS 'Device Name',
    serial AS 'Device Serial',
    vpn_mode AS 'VPN Mode',
    wan1 OR wan2 AS 'WAN Interface IP'
  WHERE instrumentation.name = 'meraki.vpn_status'
  AND org_id IS NOT NULL

  コピー
  
  

• meraki_config.monitor_vpn_status: true && meraki_config.preferences.show_vpn_peers: true:組織アプライアンスの VPN ステータスの取得エンドポイントを使用して、組織内のネットワーク全体の VPN ピアに関する情報を追加します。

  NRQL を使用して VPN ピアのテレメトリを検索します。

  FROM Metric SELECT
    latest(status) AS 'Peer Status' // Current status of this VPN peer
  FACET
    network_id AS 'Network ID',
    network AS 'Network Name',
    device_name AS 'Device Name',
    serial AS 'Device Serial',
    vpn_mode AS 'VPN Mode',
    wan1 AS 'WAN 1 IP',
    wan2 AS 'WAN 2 IP',
    peer_name AS 'Peer Name', // Name of this peer
    peer_reachability AS 'Peer Reachability', // Latest results of reachability test for this peer
    peer_network_id AS 'Peer Network ID', // Network ID for this peer
    peer_type AS 'Peer Type' // Type of Peer (Meraki vs Third-party)
  WHERE metricName = 'kentik.meraki.vpn_status.PeerStatus'

  コピー

  主な構成オプション

  ヒント

  KENTIK_MERAKI_API_KEY環境変数を使用すると、API キーを設定ファイルにプレーン テキストで保存せずに Meraki 統合に渡すことができます。

  キー名	必須	入力	説明
  meraki_config.api_key	✓ ( KENTIK_MERAKI_API_KEY環境変数を使用する場合は不要)	APIキー(文字列)	認証用のMeraki ダッシュボード API キー 。
  meraki_config.max_http_retry		1 ～ 10 の整数 (デフォルト: 2)	HTTP 429エラーを返す API リクエストで再試行する頻度を制御するオプションの設定。再試行の間隔は 5 秒です。
  meraki_config.monitor_devices		本当 | false (デフォルト: false)	組織内のすべての Meraki デバイスのステータスを監視します。
  meraki_config.monitor_org_changes		本当 | false (デフォルト: false)	組織の変更ログを監視します。
  meraki_config.monitor_uplinks		本当 | false (デフォルト: true)	組織内のすべての Meraki MX、MG、および Z シリーズ デバイスのアップリンク ステータスとパフォーマンスを監視します。
  meraki_config.monitor_vpn_status		本当 | false (デフォルト: false)	組織内のネットワーク全体の VPN ステータスを監視します。

  フィルタリングオプション

  これらのオプションを使用すると、Meraki 環境内の特定の対象オブジェクトへの監視を制限できます。

  キー名	必須	入力	説明
  meraki_config.organizations		RE2 構文の正規表現 (デフォルト: null)	すべての監視をフィルタリングして、組織の特定のリストを絞り込みます。
  meraki_config.networks		RE2 構文の正規表現 (デフォルト: null)	すべての監視をフィルタリングして、ネットワークの特定のリストを絞り込みます。
  meraki_config.product_types		有効なタイプは、ワイヤレス、アプライアンス、スイッチ、systemsManager、カメラ、セルラーゲートウェイ、センサー、およびクラウドゲートウェイです。(デフォルト: null)	特定のタイプのデバイスでフィルタリングするためのパラメータをmonitor_devices APIリクエストに追加します。

  追加の設定

  これらのオプションを使用すると、メインの構成オプションから収集されたデータをさらに定義できます。上記の例のセクションでは、さまざまな組み合わせが説明されています。

  キー名	必須	入力	説明
  meraki_config.preferences.device_status_only		本当 | false (デフォルト: false)	monitor_devices: true を使用してポーリングをステータス情報のみに制限する場合に必須です 。(これはタイムアウトの問題を防ぐために使用されます。)
  meraki_config.preferences.hide_uplink_usage		本当 | false (デフォルト: false)	monitor_uplinks と組み合わせて使用すると、パフォーマンス メトリックを削除し、アップリンクのステータス情報のみを返します。
  meraki_config.preferences.show_vpn_peers		本当 | false (デフォルト: false)	monitor_vpn_status と組み合わせて使用して、VPN ピアにテレメトリを追加します。

  最小構成例

  # This represents the minimal configuration required for a container that only performs Meraki API polling.
  # By default we only monitor uplinks. All other items are optional.
  ---
   devices:
      meraki_cloud_controller:
        device_name: meraki_cloud_controller
        device_ip: snmp.meraki.com
        provider: meraki-cloud-controller
        ext:
          ext_only: true
          meraki_config:
            api_key: "$YOUR_API_KEY"
   trap: {}
   discovery: {}
   global:
     poll_time_sec: 300
     timeout_ms: 30000

  コピー

  完全な構成例

  # This represents a configuration using all available options that creates multiple entities in New Relic.
  ---
   devices:
      # Entity 1 - monitor everything this API key has access to
      meraki_all:
        device_name: meraki_all
        device_ip: snmp.meraki.com
        provider: meraki-cloud-controller
        ext:
          ext_only: true
          meraki_config:
            api_key: "$YOUR_API_KEY_1"
            max_http_retry: 8
            monitor_devices: true
            monitor_org_changes: true
            monitor_uplinks: true
            monitor_vpn_status: true
            preferences:
              device_status_only: true
              show_vpn_peers: true
              hide_uplink_usage: false
      # Entity 2 - Monitor these specific organizations under this API key
      meraki_single_org:
        device_name: meraki_single_org
        device_ip: snmp.meraki.com
        provider: meraki-cloud-controller
        ext:
          ext_only: true
          meraki_config:
            api_key: "$YOUR_API_KEY_2"
            monitor_devices: true
            monitor_org_changes: true
            monitor_uplinks: true
            monitor_vpn_status: true
            preferences:
              device_status_only: true
              show_vpn_peers: true
              hide_uplink_usage: false
            organizations:
              - "Org 1 - Prod.*"
              - "Org 2 - Staging"
      # Entity 3 - Monitor specific devices filtered by organization, network, and product types; using the same API key from Entity 2
      meraki_filtered:
        device_name: meraki_filtered
        device_ip: snmp.meraki.com
        provider: meraki-cloud-controller
        ext:
          ext_only: true
          meraki_config:
            api_key: "$YOUR_API_KEY_2"
            monitor_devices: true
            monitor_uplinks: false
            preferences:
              device_status_only: true
            organizations:
              - "Org 3 - Remote Sites"
            networks:
              - "Corp.*99"
              - "Retail.*"
            product_types:
              - wireless
              - appliance
   trap: {}
   discovery: {}
   global:
     poll_time_sec: 300
     timeout_ms: 30000

  コピー

例：

discovery:
  cidrs: "@cidrs.yaml"

CIDRファイルは、次のようなYAMLリスト構文を使用する必要があります。

- 10.10.0.0/24
- 10.20.0.0/24
- 192.168.0.21/32

例：

devices:
  "@neteng-devices.yaml"

デバイスファイルは、メイン構成ファイルの標準devicesセクションと同じ構文を使用する必要がありますが、検出中に生成されるオプションのフィールドは省略されます。

devices:
  # Sample of SNMP v2c device
  ups_snmpv2c__10.10.0.201:
    device_name: ups_snmpv2c
    device_ip: 10.10.0.201
    snmp_comm: $YOUR_COMMUNITY_STRING
    oid: .1.3.6.1.4.1.318.1.3.27
    mib_profile: apc_ups.yml
    provider: kentik-ups
    poll_time_sec: 300
    retries: 1
    timeout_ms: 5000
    user_tags:
      owning_team: dc_ops

if_AliasがUplinkで始まる場合、またはif_interface_nameがGigで始まる場合に一致し、すべてのnullと""の値を保持します。

devices:
  deviceName:
    ...
    match_attributes:
      if_Alias: "^Uplink.*"
      if_interface_name: "^Gig.*"

if_AliasがUplinkで始まる場合、およびif_interface_nameがGigで始まる場合に一致し、すべてのnullと""の値を削除します。

devices:
  deviceName:
    ...
    match_attributes:
      if_Alias: "^Uplink.*"
      "!if_interface_name": "^Gig.*"

if_AliasがUplinkで始まる場合に一致し、すべてのnullと""の値を削除します。

devices:
  deviceName:
    ...
    match_attributes:
      "!if_Alias": "^Uplink.*"

構文： --filters $TYPE,$FIELD,$FUNCTION,$MATCH

• 10.0.0.0/24 CIDR範囲の送信元アドレスからのみフローデータを収集します

  -nf.source sflow --filters addr,src_addr,%,10.10.0.0/24

  コピー

• 宛先ポートがと等しくないフローデータのみを収集します 8531

  -nf.source netflow5 --filters int,l4_dst_port,!=,8531

  コピー

• 10.0.0.0/24 CIDR 範囲内の送信元アドレス、かつ宛先ポートが8531に等しくない送信元アドレスからのみフロー データを収集します (暗黙的なAND演算子)

  --filters addr,src_addr,%,10.0.0.0/24 --filters int,l4_dst_port,!=,8531

  コピー