메트릭 데이터 유형 쿼리

메트릭이 Metric API 를 통해 New Relic에 보고되면(해당 API를 사용하는 통합 포함) 데이터는 Metric 데이터 유형 으로 보고되며 쿼리에 사용할 수 있습니다.

이 문서는 다음을 설명합니다.

• 측정항목을 보고 쿼리 하는 방법
• 예시 메트릭 쿼리
• 와일드카드를 사용하여 여러 측정항목을 쿼리 하는 방법
• 측정항목 데이터를 탐색 하는 방법

APM 메트릭 타임슬라이스 데이터 쿼리

APM은 메트릭 타임슬라이스 데이터라고 하는 특정 유형의 데이터를 보고합니다. 쿼리하는 방법은 메트릭 타임슬라이스 데이터 쿼리 를 참조하세요.

다른 유형의 메트릭에 대한 정보는 메트릭 데이터 유형 을 참조하십시오.

측정항목 보기 및 쿼리

NRQL 을 사용하여 쿼리 빌더 에서 또는 NerdGraph API 를 사용하여 메트릭 데이터를 쿼리할 수 있습니다.

메트릭을 쿼리하려면 다음 쿼리 형식을 사용할 수 있습니다.

FROM Metric SELECT function(metric_name) WHERE attribute=value FACET attribute TIMESERIES

어떤 메트릭 데이터 유형에 대해 어떤 기능이 지원되는지에 대한 정보는 메트릭 데이터 구조 를 참조하십시오.

SELECT 절에 적절한 값 함수를 사용하여 차트로 만들 측정항목의 이름을 추가합니다. WHERE 및 FACET 절은 속성 값과 함께 사용할 수 있습니다. 데이터를 차트로 표시하려면 키워드 TIMESERIES 을 포함하는 것을 잊지 마십시오.

이 예는 클러스터 foo 에 대한 CPU 사용량을 초 단위로 차트로 표시하는 방법을 보여줍니다. 이 쿼리는 containerName 및 clusterName 속성이 있는 container_cpu_usage_seconds_total count 측정항목이 있는 경우 컨테이너별로 CPU 사용량을 분류합니다.

FROM Metric select sum(container_cpu_usage_seconds_total) 
  WHERE clusterName = 'foo' 
  FACET containerName 
  TIMESERIES

분당 CPU 사용량(변화율)을 원하면 위의 쿼리에 rate 함수를 추가할 수 있습니다.

FROM Metric select rate(sum(container_cpu_usage_seconds_total), 1 minute) 
  WHERE clusterName = 'foo' 
  FACET containerName 
  TIMESERIES

예시 메트릭 쿼리 보기

이전 예는 메트릭 쿼리의 기본 형식을 보여주지만 NRQL을 사용하여 메트릭 데이터를 차트로 작성, 탐색 및 분석할 수도 있습니다.

FROM Metric 
  SELECT latest(container_memory_usage_bytes), latest(container_spec_memory_limit_bytes) 
  WHERE containerName = 'inventory' 
  TIMESERIES

FROM Metric 
  SELECT (latest(container_spec_memory_limit_bytes) - latest(container_memory_usage_bytes)) 
    / latest(container_spec_memory_limit_bytes) 
    * 100 
    AS '% Memory Available' 
  WHERE containerName = 'inventory' 
  TIMESERIES

FROM Metric 
  SELECT filter(
    latest(
      container_memory_usage_bytes), 
    WHERE containerName = 'discovery') 
  + filter(
    latest(
      container_memory_usage_bytes), 
    WHERE containerName = 'my-proxy') 
  AS 'Total (k8s)' 
  WHERE clusterName = 'my-cluster' AND podName LIKE 'my-pilot-%' 
  TIMESERIES

FROM Metric SELECT * WHERE metricName = 'container_fs_usage_bytes' LIMIT 20 RAW

와일드카드를 사용하여 여러 측정항목 쿼리

와일드카드는 NRQL에서 % 문자로 표시됩니다. 표준 명명 규칙을 사용하는 여러 메트릭을 쿼리하려는 경우 각 메트릭 이름을 개별적으로 지정하지 않고도 와일드카드 기능을 사용하여 모든 메트릭에 대한 결과를 반환할 수 있습니다.

와일드카드는 다음과 같은 이점을 제공합니다.

• 메트릭을 함께 집계하고 결과를 차트로 표시
• FACET 차트의 메트릭 이름별 결과
• 주어진 명명 규칙과 일치하는 모든 측정항목을 찾아 차트로 표시

와일드카드는 나중에 기존 명명 규칙과 일치하는 새 메트릭을 추가하는 경우에 특히 유용합니다. 쿼리에서 각 측정항목 이름을 작성하는 대신 % 을 사용하면 새 측정항목을 추가할 때 쿼리를 다시 작성할 필요가 없습니다.

유사한 작업을 수행하는 여러 알고리즘이 있다고 가정해 보겠습니다. 다양한 알고리즘의 기간을 표시하는 다음 측정항목을 정의할 수 있습니다.

• myNeatProcess.algorithm1.duration
• myNeatProcess.algorithm2.duration
• myNeatProcess.algorithm3.duration

쿼리에 사용되는 경우 myNeatProcess.%.duration 은 위의 세 가지 알고리즘 모두에 대한 결과를 반환합니다. 나중에 algorithm4 , algorithm5 및 algorithm6 이라는 새 알고리즘을 생성하면 동일한 쿼리가 6개 알고리즘 모두에 대한 결과를 반환합니다.

FROM Metric 
    SELECT average(myNeatProcess.%.duration) 
    FACET metricName TIMESERIES

FROM Metric 
    SELECT average(myNeatProcess.%.duration) TIMESERIES

FROM Metric 
    SELECT myNeatProcess.algorithm1.duration / sum(myNeatProcess.%.duration) TIMESERIES

다음을 사용하여 개별 필드에 대한 결과 반환 getField()

여러 유형의 Metric 데이터 (예: gauge 및 count)가 있으며 각 유형에는 여러 개의 연관된 fields 이 있습니다. 사용 가능한 필드 유형에 대한 자세한 내용은 getField() 참조하세요.

getField() 사용하여 해당 필드를 추출할 수 있습니다. 예를 들어 지표 내의 단일 값을 사용하여 WHERE 절에서 비교를 수행하려는 경우 getField(metricName, field) 또는 단축 구문 metricName[field] 을 사용할 수 있습니다.

FROM Metric 
SELECT average(apm.service.transaction.duration) 
WHERE appName = 'MyApp' 
AND getField(apm.service.transaction.duration, total) / getField(apm.service.transaction.duration, count) > 2

FROM Metric 
SELECT average(apm.service.transaction.duration) 
WHERE appName = 'MyApp' 
AND apm.service.transaction.duration[total] / apm.service.transaction.duration[count] > 2

FROM Metric 
SELECT uniques(metricName) 
WHERE getField(%, type) = 'gauge'

FROM Metric 
SELECT uniques(metricName) 
WHERE %[type] = 'gauge'

측정항목 데이터 탐색

NRQL keyset 및 uniques 함수는 metricName 속성(모든 측정항목에서 사용 가능)과 함께 사용하여 계정에서 사용 가능한 모든 측정항목을 나열하거나 특정 측정항목에서 사용 가능한 속성을 검색하는 것과 같은 작업을 수행할 수 있습니다.

FROM Metric SELECT uniques(metricName)

FROM Metric SELECT uniques(metricName) WHERE hostname = 'host1.mycompany.com'

FROM Metric SELECT keyset() WHERE metricName = METRIC_NAME