뉴렐릭 Otel K8s 측정 매핑

시사

이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다!

이 기능은 현재 출시 전 정책 에 따라 미리보기 프로그램의 일부로 제공됩니다.

Kubernetes OpenTelemetry 지표는 OpenTelemetry Collector 에 의해 수집되고 뉴렐릭 Kubernetes 통합을 사용하여 뉴렐릭으로 전송됩니다.

이 문서에서는 Kubernetes OpenTelemetry 지표를 뉴렐릭 Kubernetes 지표에 매핑하는 방법을 제공합니다. 이 매핑은 쿠버네티스 클러스터를 모델링하는 데 사용할 수 있는 지표와 속성을 이해하는 데 도움이 됩니다.

다음 표는 Kubernetes OpenTelemetry 지표를 뉴렐릭 Kubernetes 지표에 매핑합니다. 이러한 메트릭은 Prometheus Receiver 로 구성된 API server 에서 제공됩니다.

OTel 메트릭	뉴렐릭 지표	뉴렐릭 이벤트 이름	유형: 설명
`apiserver_storage_objects`	`apiserverStorageObjects_resource_RESOURCE-KIND`	`K8sApiServerSample`	게이지: API 서버에 저장된 객체의 수.
`go_goroutines`	`goGoroutines`	`K8sApiServerSample`	게이지: 현재 존재하는 `goroutines` 의 개수입니다.
`go_threads`	`goThreads`	`K8sApiServerSample` , `K8sControllerManagerSample` , `K8sEtcdSample` , `K8sSchedulerSample`	게이지: 생성된 OS 스레드 수.
`process_resident_memory_bytes`	`processResidentMemoryBytes`	`K8sApiServerSample`	게이지: 상주 메모리 크기(바이트)입니다.

다음 표는 Kubernetes OpenTelemetry 지표를 뉴렐릭 Kubernetes 지표에 매핑합니다. 이러한 메트릭은 Prometheus Receiver 로 구성된 cAdvisor 에서 제공됩니다.

OTel 메트릭	뉴렐릭 지표	뉴렐릭 이벤트 이름	설명
`container_cpu_cfs_periods_total`	`containerCpuCfsPeriodsTotal`	`K8sContainerSample`	카운터: 경과된 시행 기간 간격의 총 수.
`container_cpu_cfs_throttled_periods_total`	`containerCpuCfsThrottledPeriodsTotal`	`K8sContainerSample`	카운터: 제한 기간 간격의 총 수입니다.
`container_cpu_usage_seconds_total`	`cpuUsedCores`	`K8sContainerSample`	카운터: 사용된 총 CPU 시간.
`container_memory_working_set_bytes`	`memoryWorkingSetBytes`	`K8sContainerSample`	게이지: 메모리의 작업 집합 크기(바이트)입니다.
`container_network_receive_bytes_total`	`net.rxBytesPerSecond`	`K8sPodSample`	카운터: 수신된 바이트의 누적 개수입니다.
`container_network_receive_errors_total`	`net.txBytesPerSecond`	`memoryRequestedBytes`	카운터: 수신 오류의 누적 횟수입니다.
`container_network_transmit_bytes_total`	`net.errorsPerSecond`	`K8sPodSample`	카운터: 전송된 바이트의 누적 수.
`container_network_transmit_errors_total`	`net.errorsPerSecond`	`K8sPodSample`	카운터: 발생한 전송 오류의 누적 횟수입니다.
`container_spec_memory_limit_bytes`	`memoryLimitBytes`	`K8sContainerSample`	게이지: 컨테이너의 메모리 제한(바이트)입니다.

다음 표는 Kubernetes OpenTelemetry 지표를 뉴렐릭 Kubernetes 지표에 매핑합니다. 이러한 메트릭은 Prometheus Receiver 로 구성된 controller manager 에서 제공됩니다.

OTel 메트릭	뉴렐릭 지표	뉴렐릭 이벤트 이름	설명
`go_goroutines`	`goGoroutines`	`K8sControllerManagerSample`	게이지: 현재 존재하는 `goroutines` 의 개수입니다.
`process_resident_memory_bytes`	`processResidentMemoryBytes`	`K8sControllerManagerSample`	게이지: 상주 메모리 크기(바이트)입니다.

OTel 메트릭

뉴렐릭 지표

뉴렐릭 이벤트 이름

설명

go_goroutines

goGoroutines

K8sControllerManagerSample

게이지:

현재 존재하는

goroutines

의 개수입니다.

process_resident_memory_bytes

processResidentMemoryBytes

K8sControllerManagerSample

게이지:

상주 메모리 크기(바이트)입니다.

다음 표는 Kubernetes OpenTelemetry 지표를 뉴렐릭 Kubernetes 지표에 매핑합니다. 이러한 메트릭은 KubeletStats Receiver 로 구성된 kubelet 에서 제공됩니다.

OTel 메트릭	뉴렐릭 지표	뉴렐릭 이벤트 이름	설명
`container.cpu.utilization`	`cpuCoresUtilization`	`K8sContainerSample`	게이지: 컨테이너의 CPU 사용률(%).
`container.filesystem.capacity`	`fsCapacityBytes`	`K8sContainerSample`	게이지: 컨테이너의 총 파일 시스템 용량.
`container.filesystem.usage`	`fsUsedBytes`	`K8sContainerSample`	게이지: 컨테이너에 사용된 파일 시스템 공간입니다.
`container.memory.usage`	`memoryUsedBytes`	`K8sContainerSample`	게이지: 컨테이너의 총 메모리 사용량.
`go_goroutines`	`goGoroutines`	`K8sEtcdSample`	게이지: 현재 존재하는 `goroutines` 의 개수입니다.
`go_threads`	`goThreads`	`K8sApiServerSample` , `K8sControllerManagerSample` , `K8sEtcdSample` , `K8sSchedulerSample`	게이지: 생성된 OS 스레드 수.
`k8s.node.cpu.time`	`cpuUsedCoreMilliseconds`	`K8sNodeSample`	게이지: 노드가 사용한 총 CPU 시간.
`k8s.node.cpu.utilization`	`allocatableCpuCoresUtilization`	`K8sNodeSample`	게이지: 노드의 CPU 사용률(%)입니다.
`k8s.node.filesystem.capacity`	`fsCapacityBytes`	`K8sNodeSample`	게이지: 노드의 총 파일 시스템 용량.
`k8s.node.filesystem.usage`	`fsUsedBytes`	`K8sNodeSample`	게이지: 노드에 사용된 파일 시스템 공간입니다.
`k8s.node.memory.available`	`memoryAvailableBytes`	`K8sNodeSample`	게이지: 노드에 사용 가능한 메모리.
`k8s.node.memory.working_set`	`memoryWorkingSetBytes`	`K8sNodeSample`	게이지: 노드 메모리의 작업 세트 크기.
`k8s.pod.filesystem.available`	`fsAvailableBytes`	`K8sVolumeSample`	점수: 패드에 사용 가능한 파일 시스템 공간입니다.
`k8s.pod.filesystem.capacity`	`fsCapacityBytes`	`K8sVolumeSample`	점수: 패드의 총 파일 시스템 용량입니다.
`k8s.pod.filesystem.usage`	`fsUsedBytes`	`K8sVolumeSample`	점수: 패드에 사용된 파일 시스템 공간.
`k8s.pod.memory.working_set`	`memoryWorkingSetBytes`	`K8sContainerSample`	점수: 패드 메모리의 작업 세트 크기.

다음 표는 Kubernetes OpenTelemetry 지표를 뉴렐릭 Kubernetes 지표에 매핑합니다. 이러한 메트릭은 Prometheus Receiver 로 구성된 kubelet 에서 제공됩니다.

OTel 메트릭	뉴렐릭 지표	뉴렐릭 이벤트 이름	설명
`process_resident_memory_bytes`	`processResidentMemoryBytes`	`K8sApiServerSample`	게이지: 상주 메모리 크기(바이트)입니다.

OTel 메트릭

뉴렐릭 지표

뉴렐릭 이벤트 이름

설명

process_resident_memory_bytes

processResidentMemoryBytes

K8sApiServerSample

게이지:

상주 메모리 크기(바이트)입니다.

다음 표는 Kubernetes OpenTelemetry 지표를 뉴렐릭 Kubernetes 지표에 매핑합니다. 이러한 메트릭은 Prometheus Receiver 로 구성된 kubeStateMetrics 에서 제공됩니다.

OTel 메트릭	뉴렐릭 지표	뉴렐릭 이벤트 이름	설명
`kube_cronjob_created`	`createdAt`	`K8sCronjobSample`	게이지: CronJob의 생성 타임스탬프.
`kube_cronjob_spec_suspend`	`isSuspended`	`K8sCronjobSample`	게이지: CronJob의 플래그를 일시 중단합니다.
`kube_cronjob_status_active`	`isActive`	`K8sCronjobSample`	게이지: 활성 CronJob 인스턴스 수.
`kube_cronjob_status_last_schedule_time`	`lastScheduledTime`	`K8sCronjobSample`	게이지: CronJob의 마지막 일정 시간.
`kube_daemonset_created`	`createdAt`	`K8sDaemonsetSample`	게이지: DaemonSet의 생성 타임스탬프.
`kube_daemonset_status_desired_number_scheduled`	`podsScheduled`	`K8sDaemonsetSample`	게이지: 예약된 DaemonSet 인스턴스의 원하는 수입니다.
`kube_daemonset_status_number_misscheduled`	`podsMisscheduled`	`K8sDaemonsetSample`	게이지: 잘못 예약된 DaemonSet 인스턴스의 수.
`kube_daemonset_status_number_ready`	`podsReady`	`K8sDaemonsetSample`	게이지: 준비된 DaemonSet 인스턴스의 수.
`kube_daemonset_status_number_unavailable`	`podsUnavailable`	`K8sDaemonsetSample`	게이지: 사용할 수 없는 DaemonSet 인스턴스의 수.
`kube_daemonset_status_updated_number_scheduled`	`podsUpdatedScheduled`	`K8sDaemonsetSample`	게이지: 예약된 DaemonSet 인스턴스의 수가 업데이트되었습니다.
`kube_deployment_created`	`createdAt`	`K8sDeploymentSample`	표시: 구현의 생성 타임스탬프, 배포.
`kube_deployment_metadata_generation`	`metadataGeneration`	`K8sDeploymentSample`	표시: 표시의 생성 번호, 표시데이터.
`kube_deployment_spec_replicas`	`podsDesired`	`K8sDeploymentSample`	점수: 구현, 배포에 대해 원하는 복제본 수입니다.
`kube_deployment_spec_strategy_rollingupdate_max_surge`	`rollingUpdateMaxPodsSurge`	`K8sDeploymentSample`	게이지: 롤링 업데이트 중 허용되는 최대 서지입니다.
`kube_deployment_status_condition`	`conditionAvailable` , `conditionProgressing`	`K8sDeploymentSample`	표시: 구현, 배포 상태 조건.
`kube_deployment_status_observed_generation`	`observedGeneration`	`K8sDeploymentSample`	표시: 이 구현에 대해 관찰된 가장 최근 세대, 배포입니다.
`kube_deployment_status_replicas`	`podsTotal`	`K8sDeploymentSample`	표시: 구현, 배포에 대한 복제본 수입니다.
`kube_deployment_status_replicas_available`	`podsAvailable`	`K8sDeploymentSample`	표시: 구현, 배포에 사용 가능한 복제본 수입니다.
`kube_deployment_status_replicas_ready`	`podsReady`	`K8sDeploymentSample`	표시: 구현, 배포에 대한 준비된 복제본의 수입니다.
`kube_deployment_status_replicas_unavailable`	`podsUnavailable`	`K8sDeploymentSample`	표시: 구현, 배포에 대해 사용할 수 없는 복제본 수입니다.
`kube_deployment_status_replicas_updated`	`podsUpdated`	`K8sDeploymentSample`	표시: 구현, 배포에 대한 업데이트된 복제본 수입니다.
`kube_horizontalpodautoscaler_spec_min_replicas`	`minReplicas`	`K8sHpaSample`	게이지: HorizontalPodAutoscaler의 최소 복제본 수입니다.
`kube_horizontalpodautoscaler_status_condition`	`isActive`	`K8sHpaSample`	게이지: HorizontalPodAutoscaler의 상태 조건입니다.
`kube_horizontalpodautoscaler_status_current_replicas`	`currentReplicas`	`K8sHpaSample`	게이지: HorizontalPodAutoscaler의 현재 복제본 수입니다.
`kube_horizontalpodautoscaler_status_desired_replicas`	`desiredReplicas`	`K8sHpaSample`	게이지: HorizontalPodAutoscaler에 필요한 복제본 수입니다.
`kube_job_complete`	`isComplete`	`K8sJobSample`	게이지: 작업이 완료되었는지 여부 `(1)` 또는 완료되지 않았는지 `(0)` .
`kube_job_created`	`createdAt`	`K8sJobSample`	게이지: 작업 생성 타임스탬프.
`kube_job_failed`	`failed`	`K8sJobSample`	게이지: 작업이 실패했는지 여부 `(1)` 또는 `(0)` .
`kube_job_spec_active_deadline_seconds`	`specActiveDeadlineSeconds`	`K8sJobSample`	게이지: 작업이 종료되기 전에 실행할 수 있는 시간(초)입니다.
`kube_job_spec_completions`	`specCompletions`	`K8sJobSample`	게이지: 작업을 성공적으로 완료한 파드의 원하는 수.
`kube_job_spec_parallelism`	`specParallelism`	`K8sJobSample`	점수: 작업에 대해 병렬로 실행되는 최대 원하는 패드 수입니다.
`kube_job_status_active`	`activePods`	`K8sJobSample`	점수: 해당 작업에 대한 활성 패드 수입니다.
`kube_job_status_completion_time`	`completedAt`	`K8sJobSample`	게이지: 작업 완료 시간.
`kube_job_status_failed`	`failedPods`	`K8sJobSample`	점수: 작업에 실패한 패드 수입니다.
`kube_job_status_start_time`	`startedAt`	`K8sJobSample`	게이지: 작업의 시작 시간.
`kube_job_status_succeeded`	`succeededPods`	`K8sJobSample`	점수: 해당 작업에 성공한 패드 수입니다.
`kube_node_status_allocatable`	`memoryWorkingSetUtilization`	`K8sContainerSample`	게이지: 노드에 할당 가능한 리소스.
`kube_node_status_condition`	`condition.CONDITION_NAME=CONDITION_VALUE`	`K8sNodeSample`	게이지: 노드의 상태를 나타냅니다.
`kube_persistentvolume_capacity_bytes`	`capacityBytes`	`K8sPersistentVolumeSample`	게이지: PersistentVolume의 용량(바이트)입니다.
`kube_persistentvolume_created`	`createdAt`	`K8sPersistentVolumeSample`	게이지: PersistentVolume의 생성 타임스탬프입니다.
`kube_persistentvolume_info`		`K8sPersistentVolumeSample`	게이지: PersistentVolume에 대한 정보입니다.
`kube_persistentvolume_status_phase`	`statusPhase`	`K8sPersistentVolumeSample`	게이지: PersistentVolume의 단계.
`kube_persistentvolumeclaim_created`	`createdAt`	`K8sPersistentVolumeSample`	게이지: PersistentVolumeClaim의 생성 타임스탬프.
`kube_persistentvolumeclaim_info`	볼륨을 설명하는 모든 속성	`K8sPersistentVolumeSample`	게이지: PersistentVolumeClaim에 대한 정보입니다.
`kube_persistentvolumeclaim_resource_requests_storage_bytes`	`requestedStorageBytes`	`K8sPersistentVolumeClaimSample`	게이지: PersistentVolumeClaim의 스토리지 리소스 requests (바이트)입니다.
`kube_persistentvolumeclaim_status_phase`	`statusPhase`	`K8sPersistentVolumeClaimSample`	게이지: PersistentVolumeClaim의 단계.
`kube_pod_container_resource_limits`	`cpuLimitCores` , `memoryLimitBytes`	`K8sContainerSample`	게이지: 패드컨텐츠의 리소스 제한입니다.
`kube_pod_container_resource_requests`	`cpuRequestedCores` , `memoryRequestedBytes`	`K8sContainerSample`	점수: 패드컨텐츠의 리소스 requests .
`kube_pod_container_status_phase`	`status`	`K8sContainerSample`	점수: 패드컨텐츠의 현재 단계.
`kube_pod_container_status_ready`	`isReady`	`K8sContainerSample`	게이지: 파드 컨테이너가 준비되었는지 여부 `(1)` 또는 `(0)` .
`kube_pod_container_status_restarts_total`	`restartCount`	`K8sContainerSample`	카운터: 파드컨테이너의 총 재시작 횟수입니다.
`kube_pod_container_status_waiting_reason`	`reason`	`K8sContainerSample`	게이지: 컨테이너 대기 상태에 대한 이유입니다.
`kube_pod_created`	`createdAt`	`K8sPodSample`	점수: 파드의 창조 타임스탬프.
`kube_pod_info`	패드를 설명하는 모든 속성	`K8sPodSample`	점수: 패드에 대한 정보입니다.
`kube_pod_status_phase`	`status`	`K8sPodSample`	점수: 현재 패드 상태 단계.
`kube_pod_status_ready`	`isReady`	`K8sPodSample`	점수: 패드 준비 여부 `(1)` 여부 `(0)` .
`kube_pod_status_ready_time`	`startTime`	`K8sPodSample`	게이지: 패드 상태가 준비된 시간입니다.
`kube_pod_status_scheduled`	`isScheduled`	`K8sPodSample`	점수: 패드가 예약되었는지 여부 `(1)` 또는 `(0)` .
`kube_pod_status_scheduled_time`			점수: 패드가 예정된 시간.
`kube_service_annotations`	`selector.ANNOTATIONS`	`K8sServiceSample`	게이지: 서비스에 적용된 주석입니다.
`kube_service_created`	`createdAt`	`K8sServiceSample`	게이지: 서비스 생성 타임스탬프.
`kube_service_info`	서비스를 설명하는 모든 속성	`K8sServiceSample`	게이지: 서비스에 대한 정보입니다.
`kube_service_labels`	`label.LABEL_NAME`	`K8sServiceSample`	게이지: 서비스에 적용되는 라벨입니다.
`kube_service_spec_type`	`specType`	`K8sServiceSample`	게이지: 서비스 사양의 유형입니다.
`kube_service_status_load_balancer_ingress`	필터로 필터링 `WHERE specType = 'LoadBalancer'`	`K8sServiceSample`	게이지: 서비스에 대한 로드 밸런서 수신 상태입니다.
`kube_statefulset_created`	`createdAt`	`K8sStatefulsetSample`	게이지: StatefulSet의 생성 타임스탬프.
`kube_statefulset_persistentvolumeclaim_retention_policy`	`filter with WHERE persistent = 'true'`	`K8sVolumeSample`	게이지: StatefulSet에 대한 PersistentVolumeClaims의 보존 정책입니다.
`kube_statefulset_replicas`	`podsDesired`	`K8sStatefulsetSample`	게이지: StatefulSet에 필요한 복제본 수입니다.
`kube_statefulset_status_current_revision`	`currentRevision`	`K8sStatefulsetSample`	게이지: StatefulSet의 현재 개정판입니다.
`kube_statefulset_status_replicas`	`podsTotal`	`K8sStatefulsetSample`	게이지: StatefulSet의 복제본 수.
`kube_statefulset_status_replicas_available`	`podsTotal - podsCurrent`	`K8sStatefulsetSample`	게이지: StatefulSet에 사용 가능한 복제본 수입니다.
`kube_statefulset_status_replicas_current`	`podsCurrent`	`K8sStatefulsetSample`	게이지: StatefulSet의 현재 복제본 수입니다.
`kube_statefulset_status_replicas_ready`	`podsReady`	`K8sStatefulsetSample`	게이지: StatefulSet에 대한 준비된 복제본의 수입니다.
`kube_statefulset_status_replicas_updated`	`podsUpdated`	`K8sStatefulsetSample`	게이지: StatefulSet에 대한 업데이트된 복제본의 수입니다.

다음 표는 Kubernetes OpenTelemetry 지표를 뉴렐릭 Kubernetes 지표에 매핑합니다. 이러한 메트릭은 HostMetric Receiver 로 구성된 node 에서 제공됩니다.

OTel 메트릭	뉴렐릭 지표	뉴렐릭 이벤트 이름	설명
`process.cpu.utilization`	`cpuPercent`	`ProcessSample`	게이지: 프로세스의 CPU 사용률을 백분율로 나타냅니다.
`process.disk.io`	`ioTotalReadCount+ioTotalWriteCount`	`ProcessSample`	카운터: 프로세스가 수행한 디스크 I/O 작업 수.
`process.memory.usage`	`memoryResidentSizeBytes`	`ProcessSample`	게이지: 프로세스의 메모리 사용량(바이트)입니다.
`process.memory.virtual`	`memoryVirtualSizeBytes`	`ProcessSample`	게이지: 프로세스의 가상 메모리 사용량(바이트)입니다.
`system.cpu.load_average.15m`	`loadAverageFifteenMinute`	`SystemSample`	게이지: 지난 15분 동안의 시스템 부하 평균.
`system.cpu.load_average.1m`	`loadAverageOneMinute`	`SystemSample`	게이지: 지난 1분 동안의 시스템 부하 평균.
`system.cpu.load_average.5m`	`loadAverageFiveMinute`	`SystemSample`	게이지: 지난 5분 동안의 시스템 부하 평균.
`system.cpu.utilization`	`cpuPercent`	`SystemSample`	게이지: 전체 CPU 사용률.
`system.disk.io`	`readBytesPerSecond+writeBytesPerSecond`	`StorageSample`	카운터: 수행된 디스크 I/O 작업 수.
`system.disk.io_time`	`diskReadsPerSecond+diskWritesPerSecond`	`SystemSample`	카운터: 디스크 I/O 작업에 소요된 시간(초)입니다.
`system.disk.operation_time`	`diskWriteUtilizationPercent`	`SystemSample`	카운터: 디스크 작업에 소요된 총 시간(초)입니다.
`system.disk.operations`	`readIoPerSecond`	`StorageSample`	카운터: 수행된 디스크 작업 수.
`system.filesystem.usage`	`diskUsedBytes`	`SystemSample`	게이지: 파일 시스템 공간 사용량(바이트)
`system.filesystem.utilization`	`diskUsedPercent`	`SystemSample`	게이지: 파일 시스템 활용도를 백분율로 나타낸 값입니다.
`system.memory.usage`	`memoryUsedBytes`	`SystemSample`	게이지: 총 메모리 사용량(바이트)
`system.memory.utilization`	`memoryUsedPercent`	`SystemSample`	게이지: 메모리 사용률(백분율)
`system.network.errors`	`transmitErrorsPerSecond`	`NetworkSample`	카운터: 네트워크 오류 수.
`system.network.io`	`receiveBytesPerSecond` , `transmitBytesPerSecond`	`NetworkSample`	카운터: 네트워크 I/O 작업 수.
`system.network.packets`	`transmitPacketsPerSecond+receivePacketsPerSecond`	`NetworkSample`	카운터: 전송되고 수신된 네트워크 패킷의 수.

다음 표는 Kubernetes OpenTelemetry 지표를 뉴렐릭 Kubernetes 지표에 매핑합니다. 이러한 메트릭은 Prometheus Receiver 로 구성된 scheduler 에서 제공됩니다.

OTel 메트릭	뉴렐릭 지표	뉴렐릭 이벤트 이름	설명
`go_goroutines`	`goGoroutines`	`K8sSchedulerSample`	게이지: 현재 존재하는 `goroutines` 의 개수입니다.
`process_resident_memory_bytes`	`processResidentMemoryBytes`	`K8sSchedulerSample`	게이지: 상주 메모리 크기(바이트)입니다.

OTel 메트릭

뉴렐릭 지표

뉴렐릭 이벤트 이름

설명

go_goroutines

goGoroutines

K8sSchedulerSample

게이지:

현재 존재하는

goroutines

의 개수입니다.

process_resident_memory_bytes

processResidentMemoryBytes

K8sSchedulerSample

게이지:

상주 메모리 크기(바이트)입니다.

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

시사

API 서버용

cAdvisor를 위해

컨트롤러 관리자용

kubelet의 경우

kube 상태 메트릭의 경우

노드의 경우

스케줄러용