Junos 텔레메트리 인터페이스 수집 데이터의 내보내기 형식 이해
Junos Telemetry Interface 프로토콜 버퍼(gpb) 형식으로 데이터를 내보내는 두 가지 방법을 지원합니다.
라인 카드 또는 NPU(네트워크 처리 장치)와 같이 소스에 가까운 데이터를 내보내는 소위 네이티브 센서의 UDP를 통해. 주니퍼 네트웍스 개방적이고 확장 가능한 데이터 모델을 정의합니다.
라우팅 엔진 통해 데이터를 내보내는 gRPC 원격 프로시저 호출(gRPC)을 통해. 데이터 모델은 네트워크를 구성하고 관리하기 위해 벤더 중립적인 데이터 모델의 사용을 지원하는 OpenConfig로 정의됩니다. Junos OS 위한 OpenConfig는 YANG 데이터 모델을 지원합니다. 업그레이드된 FreeBSD 커널만 기반으로 Junos OS 버전을 실행하는 플랫폼의 경우 gRPC 서버로 작동하고 RPC 인터페이스를 종료하는 네트워크 에이전트라는 별도의 패키지를 설치해야 합니다. . 다른 모든 버전의 Junos OS 경우 네트워크 에이전트 기능이 소프트웨어에 내장되어 있습니다. 또한 Junos OS 모듈 및 YANG 모델에 대한 OpenConfig를 설치해야 합니다.
이 섹션에서는 UDP를 사용하여 네이티브 센서에서 내보내는 데이터 형식을 설명합니다. 데이터는 UDP 헤더로 캡슐화되며, 이는 차례로 IPv4 페이로드에 캡슐화됩니다. 이 Junos Telemetry Interface 모델은 분산 아키텍처를 기반으로 하며, 이를 통해 구성된 센서에 의해 생성된 데이터가 데이터 플레인에서 직접 내보내기되어 컨트롤 플레인을 우회하여 이러한 리소스가 다른 필요한 기능을 수행하도록 보존합니다.
이 Junos Telemetry Interface Junos OS 릴리스 15.1F3, MPC1에서 MPC6E로 구성된 인터페이스가 있는 MX 시리즈 라우터, FPC3에 구성된 인터페이스가 있는 PTX 시리즈 라우터에서 도입되었습니다. Junos OS 릴리스 15.1F5부터 Junos Telemetry Interface MX 시리즈 라우터의 MPC7E, MPC8E 및 MPC9E에서도 지원됩니다.
Junos OS 릴리스 16.1R3부터는 FPC1, FPC2 및 PTX 시리즈 라우터의 이중 라우팅 엔진도 지원됩니다.
Junos OS 릴리스 17.2R1부터 QFX10000 및 QFX5200 스위치도 지원됩니다. QFX5200 스위치에서는 gRPC 스트리밍만 지원됩니다.
Junos OS 릴리스 17.3R1부터 Junos Telemetry Interface PTX3000 라우터, QFX5110 스위치, EX4600 및 EX9200 스위치의 라우팅 제어 및 보드(RCB)에서 지원됩니다.
Junos OS 릴리스 17.4R1부터 MX2008 라우터가 지원됩니다.
센서 데이터 캡슐화 형식 이해
네이티브 센서는 UDP를 사용하여 소스에 가까운 데이터를 내보냅니다. 물리적 인터페이스 통계, 방화벽 필터 카운터 통계 또는 레이블 스위칭 경로(LSP)에 대한 통계와 같은 다양한 유형의 텔레메트리 데이터를 내보낼 수 있습니다. 센서가 활성화되는 즉시 데이터를 방출하기 시작합니다.
센서 데이터는 라는 단일 구조화된 프로토콜 버퍼 메시지 TelemetryStream로 표시됩니다. 아래에 표시된 메시지 또는 .proto 파일에는 라인 카드, 패킷 전달 엔진 또는 라우팅 엔진 같은 데이터 소스를 식별하는 여러 속성이 포함되어 있습니다. 구성된 센서 이름도 포함되어 있습니다. 센서 구성 방법에 대한 자세한 내용은 Junos 텔레메트리 인터페이스 센서 구성(CLI 절차) 을 참조하십시오. 지원되는 네이티브 센서 목록은 센서를 참조하십시오.
또한 스트리밍 서버 또는 컬렉터에 지원되는 모든 센서의 파일을 다운로드 .proto 해야 합니다. 웹 브라우저에서 주니퍼 네트웍스 페이지의 모든 Junos 플랫폼 소프트웨어 다운로드 URL(https://www.juniper.net/support/downloads/)으로 이동합니다 . Junos OS 플랫폼의 이름과 릴리스 번호를 선택한 후 도구 섹션으로 이동하여 Junos Telemetry Interface 데이터 모델 파일 패키지를 다운로드하십시오. streaming-server 구성에 대한 자세한 내용은 streaming-server(Junos Telemetry Interface)를 참조하십시오.
프로토콜 버퍼 메시지 정의
다음은 프로토콜 버퍼 정의 TelemetryStream 언어의 메시지 정의입니다. 개인 정의 센서 데이터를 전달하는 와(과) 같은 몇 가지 선택적 네스티드 구조(예: EnterpriseSensors)를 보여줍니다.
//
// This file defines the top level message used for all Juniper
// Telemetry packets encoded to the protocol buffer format.
// The top level message is TelemetryStream.
//
import "google/protobuf/descriptor.proto";
extend google.protobuf.FieldOptions {
optional TelemetryFieldOptions telemetry_options = 1024;
}
message TelemetryFieldOptions {
optional bool is_key = 1;
optional bool is_timestamp = 2;
optional bool is_counter = 3;
optional bool is_gauge = 4;
}
message TelemetryStream {
// router name or export IP address
required string system_id = 1 [(telemetry_options).is_key = true];
// line card / RE (slot number)
optional uint32 component_id = 2 [(telemetry_options).is_key = true];
// PFE (if applicable)
optional uint32 sub_component_id = 3 [(telemetry_options).is_key = true];
// configured sensor name
optional string sensor_name = 4 [(telemetry_options).is_key = true];
// sequence number, monotonically increasesing for each
// system_id, component_id, sub_component_id + sensor_name.
optional uint32 sequence_number = 5;
// timestamp (milliseconds since 00:00:00 UTC 1/1/1970)
optional uint64 timestamp = 6 [(telemetry_options).is_timestamp = true];
// major version
optional uint32 version_major = 7;
// minor version
optional uint32 version_minor = 8;
optional IETFSensors ietf = 100;
optional EnterpriseSensors enterprise = 101;
}
message IETFSensors {
extensions 1 to max;
}
message EnterpriseSensors {
extensions 1 to max;
}
extend EnterpriseSensors {
// re-use IANA assigned numbers
optional JuniperNetworksSensors juniperNetworks = 2636;
}
message JuniperNetworksSensors {
extensions 1 to max;
}
또한 이 메시지에는 TelemetryStream 다양한 유형의 데이터를 전달하는 선택적 중첩 구조도 포함됩니다. 한 가지 구조는 엔터프라이즈, 즉 개인 정의 데이터를 전달합니다. 주니퍼 네트웍스 같은 개별 기업은 엔터프라이즈 센서에서 생성되는 속성을 정의하고 유지 관리합니다. 각 회사에는 고유한 속성 식별자가 할당됩니다. 현재 규칙은 각 속성에 IANA 할당 엔터프라이즈 관리 정보 베이스(MIB) 식별자를 사용하는 것입니다. 주니퍼 네트웍스 경우, 이 할당된 식별자는 2636입니다.
특정 메시지 유형이 내보내기 및 수신되었는지 확인하려면 gpb 메시지에서 아래 TelemetryStream.enterprise.juniperNetworks 의 속성을 확인합니다.
의미 체계 및 해당 스키마를 포함하여 센서 데이터에 의해 수집된 각 요소에 대한 설명은 표 1 을 참조하십시오.
요소 유형 |
설명 |
|---|---|
카운터 |
단조로로 증가하는 부호 없는 정수. 최대 값에 도달하면 0에서 다시 시작됩니다. |
계기 |
값을 늘리거나 줄일 수 있는 부호 없는 32비트 또는 64비트 정수입니다. 이 요소로 표시되는 데이터의 예는 대기열 깊이 또는 온도와 같은 특정 리소스의 즉각적인 값입니다. |
속도 |
카운터 또는 게이지와 같은 기본 메트릭이 변경되는 속도. 이 요소 유형에서 측정 단위는 속도 수집 간격뿐만 아니라 명시적으로 정의됩니다(예: 초당 비트). |
평균 |
기본 메트릭의 여러 샘플의 평균. 예를 들어 , 평균 대기열 깊이 데이터 요소는 대기열 깊이 의 여러 요소를 평균하여 계산됩니다. 이 요소 유형에 대해 평균을 계산하는 데 사용되는 측정 수와 측정 간의 시간 간격을 정의하는 것이 좋습니다. 그렇지 않으면 이 평균 값이 계산되는 수단을 명시적으로 정의해야 합니다. |
피크 |
기본 메트릭의 여러 샘플 중 최대 값. 예를 들어 , 피크 대기열 깊이 요소는 대기열 깊이 의 여러 측정값을 비교하고 최대값을 선택하여 계산됩니다. 이 데이터 요소 유형에 대해 최대값을 계산하는 데 사용되는 측정 수와 측정 간의 시간 간격을 정의하는 것이 좋습니다. 그렇지 않으면 이 피크 값이 어떻게 정의되는지 명시적으로 정의합니다. 또한 이 값이 삭제되지 않았는지 여부를 알아야 하며, 따라서 모든 시간에 걸쳐 전체 최대 값을 나타냅니다. |
각 데이터 요소 유형에는 요소 하위 세트도 포함됩니다. 예를 들어, 데이터 요소 Counter 및 Gauge 은(는) , , average측정 peak 에 대한 rate하위 집합을 포함합니다.