NRQL을 사용한 쿼리 인프라 차원 메트릭

차원 메트릭은 메트릭 데이터를 저장하고 쿼리하기 위한 업계 표준입니다. 모든 인프라 메트릭은 New Relic에 이벤트 데이터로 저장 되지만 차원 메트릭으로 쿼리할 수도 있습니다.

이 페이지에서 다음을 배울 수 있습니다.

• 차원 측정항목의 이점
• 사용 방법과 위치에 대한 몇 가지 예 .
• 차원 메트릭과 이벤트 데이터 쿼리의 차이점.

중요한 이유

New Relic에서는 메트릭 API, Telemetry SDK, 일부 오픈 소스 통합 및 인프라 서비스에서 사용되는 차원 메트릭 을 포함하여 여러 방법으로 메트릭 을 보고합니다.

이 유형의 측정항목을 사용하면 다음을 수행할 수 있습니다.

• 인프라 데이터에 대한 향상된 쿼리 환경을 즐기십시오.
• 한 곳에서 모든 측정항목을 확인하세요.
• Prometheus 와 같은 더 많은 메트릭 소스를 활용하십시오.

예를 들어 Lambda 함수의 최대 기간을 가져오는 쿼리는 다음과 같이 단순화됩니다.

FROM ServerlessSample
SELECT max(provider.duration.Maximum)
WHERE provider = 'LambdaFunction'

FROM Metric
SELECT max(aws.lambda.function.duration)

시작하다

이러한 메트릭을 사용하기 위해 에이전트 또는 통합 업데이트가 필요하지 않습니다.

차원 메트릭을 기반으로 하는 NRQL 경고 는 클라우드 통합에서 오는 데이터(즉, AWS 폴링 통합 , GCP 및 Azure 의 메트릭)를 제외하고도 지원됩니다. AWS CloudWatch Metric Streams 지표는 차원 지표로 수집되며 NRQL 경고가 권장됩니다.

차원 측정항목을 쿼리하는 위치 및 방법

모든 현재 NRQL 쿼리 기능 이 지원됩니다. 쿼리는 WHERE , FACET 및 SINCE , UNTIL 및 COMPARE WITH 와 같은 시간 선택 함수를 사용할 수 있습니다.

메트릭 및 속성에 대한 명명 규칙

차원 메트릭의 모든 메트릭 이름과 속성은 쉽게 찾고 사용할 수 있도록 동일한 명명 규칙을 따릅니다. 측정항목 및 속성 이름은 점으로 네임스페이스가 지정됩니다. 예를 들어 host. 접두사는 호스트 측정항목에 사용되고 k8s. 접두사는 Kubernetes 측정항목에 사용되며 aws. 는 AWS 측정항목에 사용됩니다.

아래 그래픽은 3개의 측정항목( cpuPercent , ioTotalReadBytes 및 ioTotalWriteBytes )을 포함하는 ProcessSample 이 3개의 개별 측정항목으로 분할되는 방법을 보여줍니다. 메트릭 및 속성의 업데이트된 이름을 확인합니다.

예

다음은 차원 메트릭이 있거나 없는 NQRL 쿼리의 몇 가지 예입니다.

FROM BlockDeviceSample
SELECT sum('provider.volumeTotalWriteTime.Sum')
WHERE provider = 'EbsVolume'
FACET entityName

FROM Metric
SELECT sum(aws.ebs.volume.TotalWriteTime)
FACET entity.name

FROM AzureServiceBusTopicSample
SELECT max(activeMessages.Maximum)
FACET resourceGroupName

FROM Metric
SELECT max(azure.servicebus.topic.activeMessages)
FACET azure.resourceGroup

FROM AzureFunctionsAppSample
SELECT sum(functionExecutionCount.Total)
FACET regionName
TIMESERIES SINCE 6 hours ago

FROM Metric
SELECT sum(azure.functions.app.functionExecutionCount)
FACET azure.region
TIMESERIES SINCE 6 hours ago

FROM AzureVirtualMachineScaleSetSample
SELECT uniqueCount(vMName)
FACET name
SINCE 30 MINUTES AGO COMPARE WITH 1 WEEK AGO

FROM Metric
SELECT uniqueCount(azure.vms.vmName)
FACET azure.resourceName
WHERE azure.resourceType='Microsoft.Compute/virtualMachineScaleSets'
SINCE 30 MINUTES AGO COMPARE WITH 1 WEEK AGO

FROM NginxSample
SELECT average(net.requestsPerSecond)
TIMESERIES

FROM Metric
SELECT average(nginx.server.net.requestsPerSecond)
TIMESERIES

FROM MysqlSample
SELECT max(net.maxUsedConnections)

FROM Metric
SELECT max(mysql.node.net.maxUsedConnections)

차원 메트릭 및 이벤트 쿼리의 차이점

차원 지표는 이벤트 데이터와 근본적으로 다른 유형의 데이터입니다. 데이터 유형 차이점에 대한 개요는 New Relic 데이터 유형을참조하십시오.

차원 메트릭을 쿼리할 때 몇 가지 눈에 띄는 차이점은 다음과 같습니다.

• * 가 포함된 측정항목 쿼리는 인프라 샘플 데이터를반환하지 않습니다. 예를 들어:

  SELECT * FROM Metric

  복사

• metricName LIKE 가 포함된 측정항목 쿼리는 인프라 샘플 데이터를 반환하지 않습니다. 예를 들어:

  SELECT uniques(metricName) FROM Metric where metricName like 'k8%'

  복사

• tags. 으로 시작하는 속성을 선택하려면 측정항목 이름을 제공해야 합니다. 예를 들어, 다음은 WHERE 절이 없으면 작동하지 않습니다.

  SELECT uniques(tags.environment) FROM Metric WHERE metricName='aws.lambda.function.duration'

  복사

• 선택 기준이 너무 많은 샘플과 일치하면 결과가 완전하지 않을 수 있습니다. 예를 들어 이것은 모든 인프라 샘플에 매핑되며 불완전한 결과를 반환할 수 있습니다.

  SELECT uniqueCount(entity.guid) FROM Metric

  복사

• 처음에는 새로 도입된 메트릭 와일드카드 기능에 대한 지원이 없습니다. 예를 들면 다음과 같습니다.

  SELECT average(host.swap%Bytes) FROM Metric

  복사

• 여러 메트릭에 사용되는함수는 실패하거나 잘못된 결과를 반환할 수 있습니다. 예를 들면 다음과 같습니다.

  FROM Metric SELECT latest(metricNameA + metricNameB)

  복사