SNMP 프로브 매개변수

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 5분

    • 이 매개변수 목록은 SNMP 프로브에 전달될 수 있습니다.

    프로브 매개변수 구성에 대한 지침은 프로브 매개변수 설정 문서를 참조하십시오.

    매개변수 설명 기본값
    oid_spec_list

    라인당 하나씩 OID 사양의 목록입니다. 각 사양은 다음과 같은 두 형식 중 하나여야 합니다.

    • walk {OID}: OID와 모든 하위 항목을 워크합니다.
    • table {OID} {OID Children}: 테이블의 모든 항목을 워크하고 지정된 하위 항목만 반환합니다(예시: "iso.org.dod.internet").

    {OID Children}은 지정된 테이블에 대한 항목 내의 쉼표로 구분된 하위 노드 목록을 가리킵니다. 예를 들어, "ifEntry.ifIndex,ifEntry.ifDescr,ifEntry.ifType"은 테이블 "iso.org.dod.internet.mgmt.mib-2.interfaces.ifTable"의 OID 하위 항목입니다. 편의상 테이블 항목 프리픽스를 생략할 수 있습니다. 앞의 하위 항목을 "ifIndex,ifDescr,ifType"으로 지정할 수 있습니다.

    모든 하위 항목에 필터 한정자가 괄호로 묶여 포함될 수 있습니다. 예를 들어, 하위 항목 "entPhysicalContainedIn(= 0)"은 "entPhysicalContainedIn" 값이 0인 경우에만 테이블 항목 반환을 지정합니다. 식에서 지원되는 연산자는 다음과 같습니다.
    • = : 같음
    • != : 같지 않음
    • # : 포함

    여러 하위 항목에 필터 식이 있는 경우 하위 항목과 일치하면 해당 항목이 읽힙니다.

    "//" 다음의 컨텐츠는 모두 무시됩니다(설명). "1.3.6.1" 또는 "iso.org.dod.internet"으로 시작하지 않는 모든 OID는 편의상 "1.3.6.1"로 시작합니다.

    		 required
    source SNMP를 쿼리할 장치의 IP 주소 또는 호스트 이름입니다. required
    index Cisco 스타일 커뮤니티 문자열 인덱싱(VLAN 질의)에 대해 커뮤니티 문자열 뒤에 적용할 인덱스입니다. 0
    credential_id 나머지 위에 사용하기에 적합한 특정 자격 증명의 sys_id입니다. 이 매개변수는 내부 전용이며 지원되지 않습니다. 없음
    credential_tag 사용해야 하는 자격 증명 태그입니다. 이 매개변수는 내부 전용이며 지원되지 않습니다. 없음
    timeout

    기본값 대신 응답을 기다리는 시간 제한 값(밀리초)입니다. 이 매개변수를 사용하여 mid.snmp.request.timeout SNMP MID 서버 구성 매개변수를 무효화할 수 있습니다.

    주:
    use_getbulk가 true로 설정된 경우 시간 제한 값은 개별 GETBULK 요청에 대한 값입니다.
    		 1500
    established_session_timeout 하나 이상의 응답을 받은 후 응답을 기다릴 간격(밀리초)입니다. 값이 길수록 완전하고 정확한 데이터를 수집하는 데 유용할 수 있습니다. 이 매개변수를 사용하여 mid.snmp.session.timeout SNMP MID 서버 구성 매개변수를 무효화할 수 있습니다. 500
    debug 디버그 로깅을 사용하도록 설정합니다. 디버그 모드를 사용하려면 true로 설정합니다. false
    request_interval 응답을 받지 못한 경우 시간 제한 또는 established_session_timeout 값에 도달할 때까지 OID에 대한 연속 요청 간격(밀리초)입니다. 이 값이 시간 제한(또는 established_session_timeout) 값 이상으로 설정되면 특정 OID에 대해 단일 요청만 전송됩니다. 시간 제한(또는 established_session_timeout) 값을 변경하는 경우 지정된 환경에 따라 request_interval도 적절히 조정하여 동일한 OID에 대해 요청을 너무 많이 또는 너무 적게 보내지 않도록 합니다. 400
    request_delay 응답 수신 및 다음 요청 전송 사이의 간격(밀리초)입니다. 기본값은 0(지연 없음)입니다. 이 값을 설정하여 SNMP 쿼리의 전체 속도를 늦출 수 있습니다. 0
    result_format 다음 프로브에 대한 JSON 형식의 페이로드를 반환합니다.
    • SNMP - F5 BIG-IP - 시스템
    • SNMP - Netscaler - 시스템
    • SNMP - 라우팅
    이 매개변수는 페이로드가 커질 때 노드의 센서 장애 또는 메모리 문제를 방지하기 위해 더 간결한 형식으로 데이터를 반환합니다. 이 값을 변경하거나 이 매개변수를 삭제하지 마십시오.
    경고:
    다른 프로브와 함께 이 매개변수를 사용하면 센서 장애가 발생합니다.
    		 JSON
    use_getbulk
    여러 SNMP GETNEXT 요청을 사용하는 대신 SNMP GETBULK 요청을 사용하여 SNMP 장치에서 표 형식 데이터를 검색할 수 있도록 합니다. 표 형식 데이터의 경우 GETBULK가 더 효율적입니다. 요청 유형에 관계없이 특정 장치는 다른 작업과 함께 사용 중일 때 결과를 반환하지 않을 수 있습니다. 이 매개변수는 프로브 수준에서 구성하는 데 사용됩니다. 개별 MID 서버 또는 모든 MID 서버에 대해 전역으로 GETBULK를 설정할 수도 있습니다. 설정은 우선순위에 따라 나열됩니다.

    use_getbulk가 true로 설정되면 established_session_timeout, request_interval, 및 request_delay 매개변수가 무시됩니다. 대신 retries 매개변수를 사용할 수 있습니다. 시간 제한 구성은 use_getscalar에서 사용하는 것과 같습니다.

    기본적으로 다음 프로브에서는 GETBULK 요청(매개변수 값 true)을 사용합니다.
    • SNMP - Switch - Vlan
    • SNMP - Switch - BridgePortTable
    • SNMP - Switch - ForwardingTable
    • SNMP - Switch - SpanningTreeTable
    • SNMP - Network - ArpTable
    • SNMP - 계층 2 프로토콜 캐시
    • SNMP - F5 BIG IP - 시스템(서비스 매핑 고객에만 해당)
    주:
    이러한 프로브의 timeout 값은 5000입니다.
    		 false
    use_getscalar SNMP 장치에서 스칼라 값의 단순화 검색 및 처리를 사용할 수 있도록 합니다.

    use_getscalar가 true로 설정되면 established_session_timeout, request_interval 및 request_delay 매개변수가 무시됩니다. 대신 retries 및 timeout 매개변수를 사용할 수 있습니다. 시간 제한 구성은 use_getbulk에서 사용하는 것과 같습니다.

    		 false
    retries 개별 GETBULK 요청(use_getbulk 참조)이나 GETNEXT 요청(use_getscalar 매개변수가 true로 설정된 경우)을 완료하기 위해 디스커버리가 추가로 시도하는 횟수입니다. 2