NerdGraph 튜토리얼: 로그 구문 분석 규칙 관리

api.newrelic.com/graphiql에서 NerdGraph 를 사용하여 로그에 대한 구문 분석 규칙 을 생성, 쿼리 및 관리할 수 있습니다. NerdGraph는 GraphQL 형식 API 탐색기입니다.

데이터 파싱 스키마

사용 가능한 구문 분석 규칙 필드는 다음과 같습니다.

필드	설명
id	고유한 데이터 구문 분석 식별자입니다.
파싱규칙	구문 분석 규칙의 이름입니다.
description	이 구문 분석 규칙이 나타내는 것에 대한 설명입니다.
그록	이 구문 분석 규칙에 대한 Grok 패턴입니다. 예를 들어 `logtype = 'alb'` 과 같은 내장 구문 분석 규칙 과 함께 사용 중인 Grok 패턴에 대해 `logtype` 를 포함할 수 있습니다. 그러나 `logtype` 사용에만 국한되지는 않습니다. 모든 속성을 일치 기준으로 사용할 수 있습니다.
루신	New Relic UI에서 사용된 검색 값. 예: `logtype:alb` . New Relic UI의 유효한 Lucene 함수에 대한 자세한 내용은 로그 쿼리 구문 에 대한 설명서를 참조하십시오.
회계처리	사용자의 New Relic 계정 ID입니다.
nrql	해당되는 경우 쿼리에 사용되는 NRQL 쿼리입니다. 예를 들어: "SELECT * FROM Log WHERE `logtype` = 'testLogs'"
만든이	규칙을 만든 사용자입니다. 선택사항: 여기에 `email` , `gravatar` , `id` 및 `name` 도 포함할 수 있습니다.
업데이트한 사람	규칙을 마지막으로 업데이트한 사용자입니다. 선택사항: 여기에 `email` , `gravatar` , `id` 및 `name` 도 포함할 수 있습니다.
활성화	이 구문 분석 규칙이 활성화되었는지 여부입니다.
삭제됨	이 구문 분석 규칙이 삭제되었는지 여부입니다. 구문 분석 규칙을 삭제해도 이미 라우팅된 로그는 삭제되지 않습니다.

로그 구문 분석 규칙 쿼리의 예

이 NerdGraph API 요청 예제는 주어진 계정에 대한 모든 구문 분석 규칙을 가져옵니다. 이 예에서는 사용 가능한 모든 필드가 요청됩니다.

query {
  actor {
    account(id: 12345678) {
      logConfigurations {
        parsingRules {
          accountId
          createdBy {
            email
            gravatar
            id
            name
          }
          deleted
          description
          enabled
          grok
          id
          lucene
          nrql
          updatedAt
          updatedBy {
            email
            gravatar
            id
            name
          }
        }
      }
    }
  }
}

반환된 응답은 다음과 유사합니다.

{
  "data": {
    "actor": {
      "account": {
        "id": 12345678,
        "logConfigurations": {
          "parsingRules": [
            {
              "accountId": 12345678,
              "createdBy": {
                "email": "myname@ncompany.com",
                "gravatar": "https://secure.gravatar.com/avatar/d0a88888888d666d111111111111111f",
                "id": 7777777,
                "name": "My Name"
              },
              "deleted": false,
              "description": "Integer Test",
              "enabled": true,
              "grok": "source=%{NUMBER:test:int}",
              "id": "123",
              "lucene":  ,
              "nrql": "SELECT * FROM Log WHERE `logtype` = 'integer'",
              "updatedAt": "2021-08-23T17:25:06.553Z[UTC]",
              "updatedBy": {
                "email": "myname@ncompany.com",
                "gravatar": "https://secure.gravatar.com/avatar/d0a88888888d666d111111111111111f",
                "id": 7777777,
                "name": "My Name"
              }
            }
...

구문 분석 규칙 만들기

이 예에서는 새 로그 구문 분석 규칙을 만듭니다. 규칙을 만들기 전에 로그 구문 분석 및 기본 제공 구문 분석 규칙에 대한 문서를 검토하십시오.

mutation {
  logConfigurationsCreateParsingRule(
    accountId: 12345678
    rule: {
      description: "example parsing rule"
      enabled: false
      grok: "sampleattribute=%{NUMBER:test:int}"
      lucene: "logtype:testLogs"
      nrql: "SELECT * FROM Log WHERE `logtype` = 'testLogs'"
    }
  ) {
    rule {
      id
      enabled
      description
      grok
    }
    errors {
      message
      type
    }
  }
}

구문 분석 규칙 업데이트

이 예에서는 id 이 "123" 인 구문 분석 규칙을 업데이트합니다. 필요에 따라 description , enabled , grok , lucene 및 nrql 필드를 업데이트할 수 있습니다.

mutation {
  logConfigurationsUpdateParsingRule(
    accountId: 12345678
    rule: {
      description: "example parsing rule"
      enabled: false
      grok: "sampleattribute=%{NUMBER:test:int}"
      lucene: "logtype:testLogs"
      nrql: "SELECT * FROM Log WHERE `logtype` = 'testLogs'"
    }
    id: "123"
  ) {
    errors {
      message
      type
    }
    rule {
      id
      grok
      description
      enabled
    }
  }
}

파싱 규칙 삭제

구문 분석 규칙을 삭제해도 이미 구문 분석된 데이터는 삭제되지 않습니다. 데이터는 retentionPolicy 필드에 정의된 지정된 기간 동안 유지됩니다.

mutation {
  logConfigurationsDeleteParsingRule(accountId: 123456789, id: "123") {
    errors {
      message
      type
    }
  }
}