측정항목을 New Relic으로 보내기

메트릭 데이터 포인트를 뉴렐릭으로 전송합니다.

전제조건은 뉴렐릭 Ingest 작업을 참조하십시오.

측정항목을 New Relic으로 보내기

작업 식별자는 newrelic.ingest.sendMetrics입니다.

메트릭을 뉴렐릭으로 전송합니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력	유형	설명	예시
측정항목	목록	필수 항목입니다. 메트릭 데이터 포인트 목록입니다. 각 항목의 예상 구조에 대해서는 `metrics`의 필수 핵심 가치 쌍 을 참조하십시오.	`[ { "name": "service.errors.all", "type": "count", "value": 9, "attributes": { "service.response.statuscode": "400" } },` `{ "name": "service.errors.all", "type": "gauge", "value": 4, "attributes": { "service.response.statuscode": "500" } },` `{ "name": "service.response.duration", "type": "summary", "value": { "count": 5, "sum": 0.004382655, "min": 0.0005093, "max": 0.001708826 }, "attributes": { "service.response.statuscode": "200" } } ]`
속성	지도	선택 사항. 모든 메트릭에 적용할 공통 속성입니다. 자세한 내용은 `common`을(를) 사용하여 메트릭 간에 속성 공유 를 참조하십시오.	`{ "timestamp": 1531414060739, "interval.ms": 10000, "attributes": { "app.name": "foo", "host.name": "dev.server.com" } }`
라이센스 키	문자열	선택 사항. 뉴렐릭 계정 라이선스 키는 이벤트에 대한 목표 계정을 지정합니다. 제공되지 않을 경우, 시스템은 해당 워크플로우를 실행하는 계정의 기본 라이선스 키를 사용합니다. 뉴렐릭 계정 라이선스 키를 생성하고 관리하려면 API 키에 대해 자세히 알아보십시오. 자격 증명을 일반 텍스트로 입력하지 마십시오. 예제에 표시된 시크릿 구문을 사용하십시오.	`"{{ .secrets.secretName }}"`여기서 `secretName` 라이선스 키가 저장되는 키입니다.
selectors	목록	선택 사항. 지정된 파라미터만 출력으로 가져오는 선택기입니다.	`[{"name": "error", "expression": ".errorMessage"}]`

필수 핵심 가치 쌍 `metrics`

metrics 목록의 각 지표 데이터 포인트 맵은 다음 핵심 가치 구조를 사용합니다.

기인하다	유형	설명
이름	문자열	필수 항목입니다. 메트릭의 이름. 값은 255자 미만이어야 합니다.
값	숫자 또는 지도	필수 항목입니다. 값은 메트릭 유형 에 따라 다릅니다. `gauge` 및 `count` 의 경우 값은 단일 숫자여야 합니다. `summary` 의 경우 값은 개수, 합계, 최솟값 및 최댓값을 지정하는 핵심 가치 쌍이 있는 맵이어야 합니다.
타임스탬프	긴	선택 사항. 유닉스 시간 으로 표시된 메트릭의 시작 시간입니다. 기본값은 UTC 시간대를 사용합니다. 이 필드는 초, 마이크로초 및 나노초도 지원합니다. 하지만 데이터는 저장 및 쿼리를 위해 밀리초로 변환됩니다. 보고된 시간으로부터 48시간 이상 과거이거나 24시간 이상 미래인 타임스탬프가 있는 메트릭은 삭제됩니다.
간격.ms	긍정적 장기	`count` 및 `summary` 메트릭 유형 에 필수 입니다. 시간 범위의 길이입니다.
type	문자열	권장합니다. `count` , `gauge` , `summary` 만 지원합니다. 자세한 내용은 지원되는 메트릭 유형 을 참조하십시오. 유형을 지정하지 않으면 `gauge` (으)로 기본 설정됩니다.
속성	문자열, JSON 숫자 또는 부울	권장합니다. 이 특정 메트릭과 연결된 핵심 가치 쌍의 맵입니다. 값은 문자열, JSON 숫자 또는 부울일 수 있습니다. 키는 대소문자를 구분하며 255자 미만이어야 합니다.

중요

메트릭 API는 timestamp 을 필수로 요구합니다. 액션 내에서 timestamp 은 선택 사항이며, 메트릭 수집 전에 제공되지 않으면 현재 시간으로 기본 설정됩니다.

메트릭 간에 속성 공유 `common`

여러 참조에 속성 세트를 포함시키려면(각 참조에 동일한 속성을 추가하지 않으려면) common 블록을 사용할 수 있습니다. 이는 모든 관련 데이터 포인트에 적용되는 정보를 지정하는 선택적 맵입니다. common 섹션의 값은 메트릭 데이터 포인트에 동일한 키가 있는 경우 덮어쓰여집니다.

블록에는 다음이 포함될 수 있습니다.

기인하다	유형	설명
타임스탬프	긴	측정항목의 시작 시간( Unix 시간 )입니다. UTC 표준 시간대의 현재 시간이 기본값입니다. 이 필드는 초, 마이크로초 및 나노초도 지원합니다. 그러나 데이터는 저장 및 나중에 쿼리하기 위해 밀리초로 변환됩니다.
간격.ms	긍정적 장기	`count` 및 `summary` 의 경우 필수 항목입니다 . 시간 창의 길이입니다.
속성	문자열, JSON 숫자 또는 부울	이 특정 측정항목과 연결된 키-값 쌍의 맵입니다. 값은 문자열, JSON 숫자 또는 부울일 수 있습니다.

기인하다

유형

설명

타임스탬프

긴

측정항목의 시작 시간(

Unix 시간

)입니다. UTC 표준 시간대의 현재 시간이 기본값입니다. 이 필드는 초, 마이크로초 및 나노초도 지원합니다. 그러나 데이터는 저장 및 나중에 쿼리하기 위해 밀리초로 변환됩니다.

간격.ms

긍정적 장기

count

및

summary

의 경우

필수 항목입니다

. 시간 창의 길이입니다.

속성

문자열, JSON 숫자 또는 부울

이 특정 측정항목과 연결된 키-값 쌍의 맵입니다. 값은 문자열, JSON 숫자 또는 부울일 수 있습니다.

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출	유형	설명
요청 ID	문자열	메트릭 API가 할당한 요청 식별자입니다. 예: `13325ef9-0001-b193-510f-019ba20b0792` .
success	부울	`true` 성공 시, 실패 시 `false` 입니다.
errorMessage	문자열	메시지로 표시된 실패 이유. 성공 시 `null` 입니다.

산출

유형

설명

요청 ID

문자열

메트릭 API가 할당한 요청 식별자입니다. 예:

13325ef9-0001-b193-510f-019ba20b0792

success

부울

true

성공 시, 실패 시

false

입니다.

errorMessage

문자열

메시지로 표시된 실패 이유. 성공 시

null

입니다.

다음 예제는 타임스탬프 및 상태 코드 속성과 함께 두 개의 메트릭 데이터 포인트 — 카운트와 게이지 — 를 전송합니다.

워크플로 예
`- name: sendMetrics type: action action: newrelic.ingest.sendMetrics version: 1 inputs: metrics: - name: service.errors.all type: count value: 9 timestamp: 1531414060739 attributes: service.response.statuscode: 400 - name: service.response.duration type: guage value: 4 timestamp: 1531414060733 attributes: service.response.statuscode: 500`

워크플로 예

- name: sendMetrics
    type: action
    action: newrelic.ingest.sendMetrics
    version: 1
    inputs:
      metrics:
        - name: service.errors.all
          type: count
          value: 9
          timestamp: 1531414060739
          attributes:
            service.response.statuscode: 400
        - name: service.response.duration
          type: guage
          value: 4
          timestamp: 1531414060733
          attributes:
            service.response.statuscode: 500

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

측정항목을 New Relic으로 보내기