타임슬라이스 쿼리를 NRQL로 마이그레이션

앱의 측정항목 이름 나열

애플리케이션에 사용할 수 있는 메트릭 이름을 보려면 다음을 수행하십시오.

SELECT uniques(metricTimesliceName) FROM Metric 
WHERE appId = '$APP_ID' AND newrelic.timeslice.value IS NOT NULL 
SINCE 30 MINUTES AGO LIMIT MAX

애플리케이션 이름을 사용해서 필터링할 수도 있습니다.

SELECT uniques(metricTimesliceName) FROM Metric 
WHERE appName = '$APP_NAME' AND newrelic.timeslice.value IS NOT NULL 
SINCE 30 MINUTES AGO LIMIT MAX

또는 특정 에이전트(호스트)를 사용하는 경우:

SELECT uniques(metricTimesliceName) FROM Metric 
WHERE realAgentId = '$AGENT_ID' AND newrelic.timeslice.value IS NOT NULL 
SINCE 30 MINUTES AGO LIMIT MAX

앱의 메트릭 타임슬라이스 데이터 값 가져오기

REST API v2는 지표 이름 목록과 지표 타임슬라이스 데이터를 가져오는 값 목록을 허용합니다.

메트릭 이름은 동일하므로 NRQL 쿼리의 metricTimesliceName 필드로 필터링할 수 있습니다.

각 API 값은 NRQL 함수에 매핑될 수 있습니다. 아래 표를 참조하세요.

예를 들어 다음 API 요청에 대해:

bash

$curl -X GET "https://api.newrelic.com/v2/applications/$APP_ID/metrics/data.json" \
>     -H "X-Api-Key:$API_KEY" -i \
>     -d 'names[]=HttpDispatcher&values[]=average_call_time&values[]=call_count'

다음 쿼리를 사용하면 됩니다.

SELECT count(newrelic.timeslice.value) AS call_count, 
       average(newrelic.timeslice.value) * 1000 AS average_call_time
FROM Metric
WHERE appId = $APP_ID AND metricTimesliceName = 'HttpDispatcher'

값(RPM)	NRQL 함수
`average_response_time`	`average(newrelic.timeslice.value) * 1000`
`calls_per_minute`	`rate(count(newrelic.timeslice.value), 1 minute)`
`call_count`	`count(newrelic.timeslice.value)`
`min_response_time`	`min(newrelic.timeslice.value) * 1000`
`max_response_time`	`max(newrelic.timeslice.value) * 1000`
`average_exclusive_time`	`average(newrelic.timeslice.value['totalExclusive'] / newrelic.timeslice.value['count']) * 1000`
`average_value`	`average(newrelic.timeslice.value)`
`total_call_time_per_minute`	`rate(sum(newrelic.timeslice.value), 1 minute)`
`requests_per_minute`	`rate(count(newrelic.timeslice.value), 1 minute)`
`standard_deviation`	`stddev(newrelic.timeslice.value) * 1000`
`average_time`	`average(newrelic.timeslice.value) * 1000`
`count`	`count(newrelic.timeslice.value)`
`used_bytes_by_host`	`average(newrelic.timeslice.value) * 1024 * 1024`
`used_mb_by_host`	`average(newrelic.timeslice.value)`
`total_used_mb`	`sum(newrelic.timeslice.value)`
`average_call_time`	`average(newrelic.timeslice.value) * 1000`
`total_value`	`sum(newrelic.timeslice.value)`
`min_value`	`min(newrelic.timeslice.value)`
`max_value`	`max(newrelic.timeslice.value)`
`rate`	`rate(sum(newrelic.timeslice.value), 1 second)`
`throughput`	`rate(count(newrelic.timeslice.value), 1 second)`
`as_percentage`	`average(newrelic.timeslice.value) * 100`
`errors_per_minute`	`rate(count(newrelic.timeslice.value), 1 minute)`
`error_count`	`count(newrelic.timeslice.value)`
`total_time`	`sum(newrelic.timeslice.value) * 1000`
`sessions_active`	`average(newrelic.timeslice.value)`
`total_visits`	`sum(newrelic.timeslice.value)`
`percent`	`average(newrelic.timeslice.value) * 100`
`percent(CPU/User Time)`	`100 * sum(newrelic.timeslice.value) / $TIME_WINDOW_IN_SECONDS`
`time_percentage`	`100 * sum(newrelic.timeslice.value) / $TIME_WINDOW_IN_SECONDS`
`utilization`	`100 * sum(newrelic.timeslice.value) / $TIME_WINDOW_IN_SECONDS`
`visits_percentage`	`100 * sum(newrelic.timeslice.value) / $TIME_WINDOW_IN_SECONDS`

함수에 $TIME_WINDOW_IN_SECONDS 포함되어 있는 경우 이를 쿼리하려는 시간 창으로 바꿔야 함을 의미합니다.

예를 들어, 30분 시간 창을 쿼리하는 경우 $TIME_WINDOW_IN_SECONDS 1800 로 바꿔야 합니다.

Apdex 메트릭

값(RPM)	NRQL 함수
`score`	`apdex(newrelic.timeslice.value)`
`s`	`apdex(newrelic.timeslice.value)` 또는 `count(newrelic.timeslice.value)`
`t`	`apdex(newrelic.timeslice.value)` 또는 `sum(newrelic.timeslice.value)`
`f`	`apdex(newrelic.timeslice.value)` 또는 `sum(newrelic.timeslice.value['totalExclusive'])`
`count`	`apdex(newrelic.timeslice.value)`
`value`	`apdex(newrelic.timeslice.value)`
`threshold`	`max(newrelic.timeslice.value)`
`threshold_min`	`min(newrelic.timeslice.value)`

최종 사용자 및 모바일 사용자

이러한 지표는 REST API v2에서 얻을 수 있는 것과 동일한 결과를 반환하지만, 일부 결과는 뉴렐릭 UI 에서 보는 것과 다를 수 있습니다. 이는 UI가 타임슬라이스 데이터 대신 이벤트를 사용하기 때문입니다. UI와 동일한 결과를 얻으려면 이벤트를 직접 쿼리해야 합니다.

값(RPM)	NRQL 함수
`average_response_time`	`sum(newrelic.timeslice.value) / count(newrelic.timeslice.value) * 1000`
`error_percentage`	`(filter(count(newrelic.timeslice.value), WHERE metricTimesliceName = 'EndUser/errors') / filter(count(newrelic.timeslice.value), WHERE metricTimesliceName = 'Browser'))`
`average_fe_response_time`	`sum(newrelic.timeslice.value['totalExclusive']) / count(newrelic.timeslice.value) * 1000`
`average_be_response_time`	`1000 * (sum(newrelic.timeslice.value) - sum(newrelic.timeslice.value['totalExclusive'])) / count(newrelic.timeslice.value)`
`average_network_time`	`(sum(newrelic.timeslice.value) - sum(newrelic.timeslice.value['totalExclusive']) - sum(newrelic.timeslice.value['sumOfSquares'])) / count(newrelic.timeslice.value)`
`total_network_time`	`(sum(newrelic.timeslice.value) - sum(newrelic.timeslice.value['totalExclusive']) - sum(newrelic.timeslice.value['sumOfSquares']))`
`network_time_percentage`	`(sum(newrelic.timeslice.value) - sum(newrelic.timeslice.value['totalExclusive']) - sum(newrelic.timeslice.value['sumOfSquares'])) / $TIME_WINDOW_IN_SECONDS`
`total_fe_time`	`sum(newrelic.timeslice.value['totalExclusive'])`
`fe_time_percentage`	`100 * sum(newrelic.timeslice.value['totalExclusive']) / $TIME_WINDOW_IN_SECONDS`
`average_dom_content_load_time`	`average(newrelic.timeslice.value) * 1000`
`average_queue_time`	`average(newrelic.timeslice.value['totalExclusive']) * 1000`
`total_queue_time`	`sum(newrelic.timeslice.value['totalExclusive']) * 1000`
`total_dom_content_time`	`sum(newrelic.timeslice.value) * 1000`
`total_app_time`	`sum(newrelic.timeslice.value['sumOfSquares'])`
`average_app_time`	`sum(newrelic.timeslice.value['sumOfSquares']) / count(newrelic.timeslice.value)`
`average_sent_bytes`	`sum(newrelic.timeslice.value['totalExclusive']) * 1000`
`average_received_bytes`	`1000 * sum(newrelic.timeslice.value) / count(newrelic.timeslice.value)`
`launch_count`	`count(newrelic.timeslice.value)`

시계열 및 요약

기본적으로 REST API는 일련의 메트릭 데이터 값을 반환합니다. 이러한 값의 평균을 구하려면 API 호출에 &summarize=true 포함시킵니다.

NRQL에서는 그 반대입니다. 기본적으로 요약을 얻을 수 있으며, 쿼리에 TIMESERIES 추가하여 시계열을 얻을 수 있습니다.

또 다른 차이점은 REST API의 기본 시간 창이 30분인 반면 NRQL에서는 1시간이라는 것입니다.

여러 메트릭 쿼리

NRQL을 사용하면 여러 메트릭을 동시에 쿼리할 수 있습니다. 다음은 그 예입니다.

SELECT
    filter(1000 * average(newrelic.timeslice.value), WHERE metricTimesliceName = 'HttpDispatcher') AS average_response_time,
    filter(count(newrelic.timeslice.value), WHERE metricTimesliceName = 'Errors/all') AS error_count,
    filter(average(newrelic.timeslice.value), WHERE metricTimesliceName = 'Memory/Heap/Max') AS used_mb_by_host
FROM Metric
WHERE appName = '$APP_NAME'
SINCE 1 day ago