• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

In the event of any inconsistency between the English version and the translated version, the English versionwill take priority. Please visit this page for more information.

문제 신고

Meraki 대시보드 API 모니터링 설정

New Relic의 네트워크 모니터링 에이전트를 사용하여 Meraki 환경을 감시할 수 있습니다.

시작하다

시작하기 전에 New Relic, Docker, Meraki 및 네트워크 보안 필수 구성 요소가 있는지 확인하세요.

네트워크 방화벽 규칙

방향

원천

목적지

항구

규약

필수의

배 밖으로

컨테이너 호스트

ktranslate Docker Hub, Quay.io 또는 회사 내부 저장소의 이미지.

443

TCP

배 밖으로

컨테이너 호스트

New Relic Metric API 엔드포인트: https://metric-api.newrelic.com

443

TCP

배 밖으로

컨테이너 호스트

New Relic 이벤트 API 끝점: https://insights-collector.newrelic.com

443

TCP

배 밖으로

컨테이너 호스트

New Relic 로그 API 끝점: https://log-api.newrelic.com

443

TCP

배 밖으로

컨테이너 호스트

Meraki 대시보드 API 엔드포인트: https://api.meraki.com/api/v1/

443(기본값)

TCP

설치

Meraki 대시보드 API 모니터링을 기존 SNMP 컨테이너에 추가하거나 전용 컨테이너에 구현, 배포하고 다른 SNMP 장치와 별도로 유지할 수 있습니다. 아래에서 사용 사례에 가장 적합한 옵션을 선택하세요.

  1. SNMP 에이전트에 대한 기존 설정 파일에서 Meraki 장치 개체를 수동으로 추가합니다. $DASHBOARD_API_KEY Meraki 대시보드 API 키로 바꿉니다.

    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: "$DASHBOARD_API_KEY"

    이것은 기본적인 예입니다. 고급 설정 문서 에서 추가 설정 옵션을 찾을 수 있습니다.

  2. 기존 컨테이너를 중지하고 제거합니다.

    bash
    $
    # Find your current container
    $
    docker ps -a
    $
    $
    # Forcibly stop and delete the target container (you may also use the container ID here in place of the name)
    $
    docker rm -f $CONTAINER_NAME
  3. 업데이트된 설정 파일로 새로운 컨테이너를 시작하세요. $CONTAINER_SERVICE 컨테이너의 고유 이름으로 바꾸고, $YOUR_NR_LICENSE_KEY$YOUR_NR_ACCOUNT_ID 원하는 값으로 바꾸세요. 이 예에서는 기본 설정 파일의 이름이 snmp-base.yaml 이라고 가정합니다.

    bash
    $
    docker run -d --name ktranslate-$CONTAINER_SERVICE --restart unless-stopped --pull=always -p 162:1620/udp \
    >
    -v `pwd`/snmp-base.yaml:/snmp-base.yaml \
    >
    -e NEW_RELIC_API_KEY=$YOUR_NR_LICENSE_KEY \
    >
    kentik/ktranslate:v2 \
    >
    -snmp /snmp-base.yaml \
    >
    -nr_account_id=$YOUR_NR_ACCOUNT_ID \
    >
    -metrics=jchf \
    >
    -tee_logs=true \
    >
    -service_name=$CONTAINER_SERVICE \
    >
    -snmp_discovery_on_start=true \
    >
    -snmp_discovery_min=180 \
    >
    nr1.snmp
  1. docker 설치된 Linux 호스트에서 선택한 텍스트 편집기를 사용하여 컨테이너를 실행하는 데 사용할 설정 파일을 만듭니다. $DASHBOARD_API_KEY Meraki 대시보드 API 키로 바꿉니다.

    vim을 사용한 예:

    bash
    $
    sudo vim meraki-base.yaml

    파일 내용:

    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: "$DASHBOARD_API_KEY"
    trap: {}
    discovery: {}
    global:
    poll_time_sec: 300
    timeout_ms: 30000

    이것은 기본적인 예입니다. 고급 설정 문서 에서 추가 설정 옵션을 찾을 수 있습니다.

  2. Meraki 대시보드 API를 폴링하려면 네트워크 모니터링 에이전트를 시작하세요. $CONTAINER_SERVICE 컨테이너의 고유 이름으로 바꾸고, $YOUR_NR_LICENSE_KEY$YOUR_NR_ACCOUNT_ID 원하는 값으로 바꾸세요. 이 예에서는 설정 파일을 'meraki-base.yaml'로 저장했습니다.

    bash
    $
    docker run -d --name ktranslate-$CONTAINER_SERVICE --restart unless-stopped --pull=always -p 162:1620/udp \
    >
    -v `pwd`/meraki-base.yaml:/snmp-base.yaml \
    >
    -e NEW_RELIC_API_KEY=$YOUR_NR_LICENSE_KEY \
    >
    kentik/ktranslate:v2 \
    >
    -snmp /snmp-base.yaml \
    >
    -nr_account_id=$YOUR_NR_ACCOUNT_ID \
    >
    -metrics=jchf \
    >
    -tee_logs=true \
    >
    -service_name=$CONTAINER_SERVICE \
    >
    -snmp_discovery_on_start=true \
    >
    -snmp_discovery_min=180 \
    >
    nr1.snmp
  1. SNMP 에이전트에 대한 기존 설정 파일에서 Meraki 장치 개체를 수동으로 추가합니다. $DASHBOARD_API_KEY Meraki 대시보드 API 키로 바꿉니다.

    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: "$DASHBOARD_API_KEY"

    이것은 기본적인 예입니다. 고급 설정 문서 에서 추가 설정 옵션을 찾을 수 있습니다.

  2. 기존 컨테이너를 중지하고 제거합니다.

    bash
    $
    # Find your current container
    $
    podman ps -a
    $
    $
    # Forcibly stop and delete the target container (you may also use the container ID here in place of the name)
    $
    podman rm -f $CONTAINER_NAME
  3. 업데이트된 설정 파일로 새로운 컨테이너를 시작하세요. $CONTAINER_SERVICE 컨테이너의 고유 이름으로 바꾸고, $YOUR_NR_LICENSE_KEY$YOUR_NR_ACCOUNT_ID 원하는 값으로 바꾸세요. 이 예에서는 기본 설정 파일 이름이 snmp-base.yaml 이라고 가정합니다.

    bash
    $
    podman run -d --name ktranslate-$CONTAINER_SERVICE --userns=keep-id --restart unless-stopped --pull=always --net=host \
    >
    -v `pwd`/snmp-base.yaml:/snmp-base.yaml \
    >
    -e NEW_RELIC_API_KEY=$YOUR_NR_LICENSE_KEY \
    >
    kentik/ktranslate:v2 \
    >
    -snmp /snmp-base.yaml \
    >
    -nr_account_id=$YOUR_NR_ACCOUNT_ID \
    >
    -metrics=jchf \
    >
    -tee_logs=true \
    >
    -service_name=$CONTAINER_SERVICE \
    >
    -snmp_discovery_on_start=true \
    >
    -snmp_discovery_min=180 \
    >
    nr1.snmp

    중요

    트랩 메시지에 대한 패킷 리디렉션을 처리하기 위한 iptables 규칙을 아직 생성하지 않은 경우 다음 명령을 사용하여 생성해야 합니다.

    bash
    $
    sudo iptables -t nat -A PREROUTING -p udp --dport 162 -j REDIRECT --to-port 1620
  1. Podman이 설치된 Linux 호스트에서 원하는 텍스트 편집기를 사용하여 컨테이너를 실행하는 데 사용할 설정 파일을 만듭니다. $DASHBOARD_API_KEY Meraki 대시보드 API 키로 바꿉니다.

    vim을 사용한 예:

    bash
    $
    sudo vim meraki-base.yaml

    파일 내용:

    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: "$DASHBOARD_API_KEY"
    trap: {}
    discovery: {}
    global:
    poll_time_sec: 300
    timeout_ms: 30000

    이것은 기본적인 예입니다. 고급 설정 문서 에서 추가 설정 옵션을 찾을 수 있습니다.

  2. Meraki 대시보드 API를 폴링하려면 네트워크 모니터링 에이전트를 시작하세요. $CONTAINER_SERVICE 컨테이너의 고유 이름으로 바꾸고, $YOUR_NR_LICENSE_KEY$YOUR_NR_ACCOUNT_ID 원하는 값으로 바꾸세요. 이 예에서는 설정 파일을 'meraki-base.yaml'로 저장했습니다.

    bash
    $
    podman run -d --name ktranslate-$CONTAINER_SERVICE --userns=keep-id --restart unless-stopped --pull=always --net=host \
    >
    -v `pwd`/snmp-base.yaml:/snmp-base.yaml \
    >
    -e NEW_RELIC_API_KEY=$YOUR_NR_LICENSE_KEY \
    >
    kentik/ktranslate:v2 \
    >
    -snmp /snmp-base.yaml \
    >
    -nr_account_id=$YOUR_NR_ACCOUNT_ID \
    >
    -metrics=jchf \
    >
    -tee_logs=true \
    >
    -service_name=$CONTAINER_SERVICE \
    >
    -snmp_discovery_on_start=true \
    >
    -snmp_discovery_min=180 \
    >
    nr1.snmp

    중요

    트랩 메시지에 대한 패킷 리디렉션을 처리하기 위한 iptables 규칙을 아직 생성하지 않은 경우 다음 명령을 사용하여 생성해야 합니다.

    bash
    $
    sudo iptables -t nat -A PREROUTING -p udp --dport 162 -j REDIRECT --to-port 1620

무엇 향후 계획

Meraki 환경 데이터를 보완하기 위해 더 많은 에이전트를 설정할 수 있습니다.


이 문서가 설치하는데 도움이 되셨나요?

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.