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 와 같은 시간 선택 함수를 사용할 수 있습니다.

쿼리 작성기 는 단순 및 고급(NRQL) 모드 모두에서 측정항목을 지원합니다.

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

차원 메트릭의 모든 메트릭 이름과 속성은 쉽게 찾고 사용할 수 있도록 동일한 명명 규칙을 따릅니다. 측정항목 및 속성 이름은 점으로 네임스페이스가 지정됩니다. 예를 들어 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)

알려진 제한 사항

• * 이 있는 측정항목 쿼리는 인프라 샘플 데이터(예: SELECT * FROM Metric )를 반환하지 않습니다.
• tags. 으로 시작하는 속성을 선택하려면 측정항목 이름을 제공해야 합니다. 예를 들어, SELECT uniques(tags.environment) FROM Metric WHERE metricName='aws.lambda.function.duration' 은 WHERE 절 없이 작동하지 않습니다.
• 선택 기준이 너무 많은 샘플과 일치하는 경우 결과가 완전하지 않을 수 있습니다. 예를 들어, SELECT uniqueCount(entity.guid) FROM Metric 은 모든 인프라 샘플에 매핑되며 불완전한 결과를 반환할 수 있습니다.
• 처음에는 새로 도입된 측정항목 와일드카드 기능(예: SELECT average(host.swap%Bytes) FROM Metric )에 대한 지원이 없습니다.