수집된 데이터의 Junos Telemetry Interface 내보내기 형식 이해
Junos Telemetry Interface는 프로토콜 버퍼(gpb) 형식으로 데이터를 내보내는 두 가지 방법을 지원합니다.
라인 카드 또는 NPU(Network Processing Unit)와 같이 소스에 가까운 곳에서 데이터를 내보내는 소위 네이티브 센서의 UDP를 통해. 주니퍼 네트웍스는 개방적이고 확장 가능한 데이터 모델을 정의합니다.
라우팅 엔진을 통해 데이터를 내보내는 gRPC 원격 프로시저 호출(gRPC)을 통해. 데이터 모델은 OpenConfig에 의해 정의되며, 벤더 중립적인 데이터 모델을 사용하여 네트워크를 구성하고 관리할 수 있도록 지원합니다. Junos OS용 OpenConfig는 YANG 데이터 모델을 지원합니다. 업그레이드된 FreeBSD 커널만을 기반으로 Junos OS 버전을 실행하는 플랫폼의 경우, gRPC 서버 역할을 하고 RPC 인터페이스를 종료하는 네트워크 에이전트라는 별도의 패키지를 설치해야 합니다. . 다른 모든 Junos OS 버전의 경우, 네트워크 에이전트 기능이 소프트웨어에 내장되어 있습니다. Junos OS용 OpenConfig 모듈 및 YANG 모델도 설치해야 합니다.
이 섹션에서는 UDP를 사용하여 기본 센서에서 내보낸 데이터 형식에 대해 설명합니다. 데이터는 UDP 헤더로 캡슐화되고, UDP 헤더는 IPv4 페이로드에 캡슐화됩니다. Junos Telemetry Interface의 이 모델은 분산 아키텍처를 기반으로 하며, 이를 통해 구성된 센서에서 생성된 데이터가 컨트롤 플레인을 우회하여 데이터 플레인에서 직접 내보내지므로 이러한 리소스를 절약하여 다른 필요한 기능을 수행할 수 있습니다.
Junos 텔레메트리 인터페이스는 Junos OS 릴리스 15.1F3, MPC1에서 MPC6E까지 구성된 인터페이스가 있는 MX 시리즈 라우터, FPC3에 구성된 인터페이스가 있는 PTX 시리즈 라우터에서 소개되었습니다. Junos OS 릴리스 15.1F5부터 Junos Telemetry Interface는 MX 시리즈 라우터의 MPC7E, MPC8E 및 MPC9E에서도 지원됩니다.
Junos OS 릴리스 16.1R3부터 PTX 시리즈 라우터의 FPC1, FPC2 및 듀얼 라우팅 엔진도 지원됩니다.
Junos OS 릴리스 17.2R1부터 QFX10000 및 QFX5200 스위치도 지원됩니다. QFX5200 스위치에서는 gRPC 스트리밍만 지원됩니다.
Junos OS 릴리스 17.3R1부터 Junos Telemetry Interface는 PTX3000 라우터, QFX5110 스위치, EX4600 및 EX9200 스위치의 RCB(Routing Control and Board)에서 지원됩니다.
Junos OS 릴리스 17.4R1부터 MX2008 라우터가 지원됩니다.
센서 데이터 캡슐화 형식 이해
기본 센서는 UDP를 사용하여 소스에 가까운 데이터를 내보냅니다. 물리적 인터페이스 통계, 방화벽 필터 카운터 통계 또는 LSP(label-switched paths) 통계와 같은 다양한 유형의 텔레메트리 데이터를 내보낼 수 있습니다. 센서는 활성화되자마자 데이터를 방출하기 시작합니다.
센서 데이터는 라는 TelemetryStream단일 구조화된 프로토콜 버퍼 메시지로 표시됩니다. 아래에 표시된 메시지 또는 파일에는 라인 카드, 패킷 전달 엔진 또는 .proto 라우팅 엔진과 같이 데이터 소스를 식별하는 여러 속성이 포함되어 있습니다. 구성된 센서의 이름도 포함됩니다. 센서 구성 방법에 대한 자세한 내용은 Junos Telemetry Interface 센서 구성(CLI 절차) 을 참조하십시오. 지원되는 기본 센서 목록은 센서를 참조하십시오.
또한 지원되는 모든 센서에 .proto 대한 파일을 스트리밍 서버 또는 수집기에 다운로드해야 합니다. 웹 브라우저에서 주니퍼 네트웍스 페이지의 모든 Junos 플랫폼 소프트웨어 다운로드 URL: https://www.juniper.net/support/downloads/ 로 이동합니다. Junos OS 플랫폼의 이름과 릴리스 번호를 선택한 후 도구 섹션으로 이동하여 Junos 텔레메트리 인터페이스 데이터 모델 파일 패키지를 다운로드합니다. 스트리밍 서버 구성에 대한 자세한 내용은 스트리밍 서버(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 및 에는 , average및 측정에 대한 rate하위 집합이 peak 포함됩니다.Gauge
변경 내역 테이블
기능 지원은 사용 중인 플랫폼 및 릴리스에 따라 결정됩니다. 기능 탐색기 를 사용하여 플랫폼에서 기능이 지원되는지 확인합니다.