Cloudflare Logpush를 사용하여 로그 전달

Cloudflare 대시보드를 사용하거나 API를 통해 New Relic에 로그를 보내도록 Cloudflare Logpush 서비스를 구성합니다.

Cloudflare 대시보드를 통한 관리

Cloudflare 대시보드를 통해 New Relic에 대한 Logpush 서비스를 활성화하려면:

1. Cloudflare 대시보드 에 로그인하고 Logpush와 함께 사용할 엔터프라이즈 도메인을 선택합니다.

2. Analytics > Logs 로 이동합니다.

3. 서비스 연결을 클릭하여 모달 창을 엽니다.

4. 스토리지 서비스에 푸시할 데이터 세트를 선택합니다.

5. 로그에 포함할 데이터 필드를 선택합니다. Logs > Logpush 에서 설정을 수정하여 나중에 필드를 추가하거나 제거할 수 있습니다.

6. 새 유물 을 선택합니다.

7. New Relic의 로그 엔드포인트 입력:

   우리를: "https://log-api.newrelic.com/log/v1?Api-Key=<NR_LICENSE_KEY>&format=cloudflare"

   유럽 연합: "https://log-api.eu.newrelic.com/log/v1?Api-Key=<NR_LICENSE_KEY>&format=cloudflare"

   New Relic 계정에 설정한 지역을 사용하세요. <NR_LICENSE_KEY> 을 UI 또는 API에서 검색 할 수 있는 New Relic 라이선스 키로 대체합니다.

8. 액세스 확인 을 클릭합니다.

9. 저장 및 푸시 시작 을 클릭하여 Logpush 활성화를 완료합니다.

연결되면 Cloudflare는 Logs > Logpush 아래에 New Relic을 연결된 서비스로 나열합니다. 여기에서 연결된 서비스를 편집하거나 제거합니다.

Cloudflare API를 통한 관리

1. 작업 생성

작업을 생성하려면 다음 필드를 사용하여 Logpush 작업 엔드포인트에 대한 POST 요청을 수행합니다.

• name (선택 사항): 도메인 이름을 작업 이름으로 사용합니다.

• logpull_options (선택 사항): 필드, 샘플 속도 및 타임스탬프 형식을 구성하려면 Logpush API 옵션 을 참조하십시오. Cloudflare 로그를 쿼리하기 위해 New Relic은 필드를 Unix 타임스탬프로 전송해야 합니다.

• destination_conf: 엔드포인트 URL, 라이선스 키 및 다음 문자열 형식의 형식으로 구성된 로그 대상:

  <NR_ENDPOINT_URL>: New Relic 계정에 설정된 지역에 따라 미국의 경우 https://log-api.newrelic.com/log/v1 , EU의 경우 https://log-api.eu.newrelic.com/log/v1 인 New Relic HTTP 로그 수집 엔드포인트. <NR_LICENSE_KEY> : UI 또는 API에서 검색 할 수 있는 New Relic 라이선스 키로 교체합니다. format : 형식은 cloudflare 입니다.

  예를 들어:

  우리를: "https://log-api.newrelic.com/log/v1?Api-Key=<NR_LICENSE_KEY>&format=cloudflare"

  유럽 연합: "https://log-api.eu.newrelic.com/log/v1?Api-Key=<NR_LICENSE_KEY>&format=cloudflare"

• max_upload_records (선택 사항): 배치당 최대 로그 줄 수입니다. 최소 1,000줄 이상이어야 합니다. 배치당 최소 로그 줄 수를 지정할 수 있는 방법은 없습니다. 이는 로그 파일에 지정된 것보다 훨씬 적은 행이 포함될 수 있음을 의미합니다.

• max_upload_bytes (선택 사항): 일괄 로그의 압축되지 않은 최대 파일 크기입니다. 최소 5MB 이상이어야 합니다. 최소 파일 크기를 설정할 수 있는 방법은 없습니다. 이는 로그 파일이 이 배치 크기보다 훨씬 작을 수 있음을 의미합니다. 그럼에도 불구하고 이 매개변수를 5,000,000으로 설정하는 것이 좋습니다.

• dataset: 수신하려는 로그의 범주입니다. 지원되는 데이터 세트의 전체 목록은 Cloudflare의 로그 필드 문서 를 참조하십시오.

cURL을 사용한 요청 예:

$
curl -s https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/logpush/jobs -X POST -d '
$
{
$
  "name": "<DOMAIN_NAME>",
$
  "logpull_options": "fields=ClientIP,ClientRequestHost,ClientRequestMethod,ClientRequestURI,EdgeEndTimestamp,EdgeResponseBytes,EdgeResponseStatus,EdgeStartTimestamp,RayID&timestamps=unix",
$
  "destination_conf": "https://log-api.newrelic.com/log/v1?Api-Key=<NR_LICENSE_KEY>&format=cloudflare",
$
  "max_upload_bytes": 5000000,
$
  "dataset": "http_requests",
$
  "enabled": true
$
}' \
>
-H "X-Auth-Email: <EMAIL>" \
>
-H "X-Auth-Key: <API_KEY>" | jq .

응답:

$
{
$
  "errors" : [],
$
  "messages" : [],
$
  "result" : {
$
      "dataset" : "http_requests",
$
      "destination_conf" : "https://log-api.newrelic.com/log/v1?Api-Key=<NR_LICENSE_KEY>&format=cloudflare",
$
      "enabled" : true,
$
      "error_message" : null,
$
      "frequency" : "high",
$
      "id" : 100,
$
      "kind" : "",
$
      "last_complete" : null,
$
      "last_error" : null,
$
      "logpull_options" : "fields=ClientIP,ClientRequestHost,ClientRequestMethod,ClientRequestURI,EdgeEndTimestamp,EdgeResponseBytes,EdgeResponseStatus,EdgeStartTimestamp,RayID&timestamps=unix",
$
      "logstream" : true,
$
      "max_upload_bytes" : 5000000,
$
      "name" : "<DOMAIN_NAME>"
$
  },
$
  "success" : true
$
}

2. 작업 활성화(업데이트)

작업을 활성화하려면 Logpush 작업 엔드포인트에 PUT 요청을 보냅니다. URL의 이전 단계에서 반환된 작업 ID를 사용하고 요청 본문에 {"enabled": true} 을 보냅니다.

cURL을 사용한 요청 예:

$
curl -s -X PUT \
>
https://api.cloudflare.com/client/v4/zones/<ZONE_ID>/logpush/jobs/100 -d'{"enabled":true}' \
>
-H "X-Auth-Email: <EMAIL>" \
>
-H "X-Auth-Key: <API_KEY>" | jq .

응답:

$
{
$
  "errors" : [],
$
  "messages" : [],
$
  "result" : {
$
      "dataset" : "http_requests",
$
      "destination_conf" : "https://log-api.newrelic.com/log/v1?Api-Key=<NR_LICENSE_KEY>&format=cloudflare",
$
      "enabled" : true,
$
      "error_message" : null,
$
      "frequency" : "high",
$
      "id" : 100,
$
      "kind" : "",
$
      "last_complete" : "null",
$
      "last_error" : null,
$
      "logpull_options" : "fields=ClientIP,ClientRequestHost,ClientRequestMethod,ClientRequestURI,EdgeEndTimestamp,EdgeResponseBytes,EdgeResponseStatus,EdgeStartTimestamp,RayID&timestamps=unix",
$
      "logstream" : true,
$
      "max_upload_bytes" : 5000000,
$
      "name" : "<DOMAIN_NAME>"
$
  },
$
  "success" : true
$
}

다음은 뭐지?

Cloudflare 네트워크 로그에서 주요 지표를 확인하기 위해 미리 구축된 대시보드로 몇 분 안에 시작하세요.

• New Relic Instant Observability에서 Cloudflare 네트워크 로그 빠른 시작 으로 이동하고 + 빠른 시작 설치 를 클릭합니다.
• 블로그 게시물을 읽고 통합에 대해 자세히 알아보십시오: Cloudflare Logpush 통합으로 New Relic One에 로그 통찰력을 보내는 더 빠르고 저렴한 방법
• 로그 UI 를 사용하여 플랫폼 전반에 걸쳐 로깅 데이터를 탐색하십시오.
• 컨텍스트에서 로그 기능을 사용하여 로그를 전달하여 애플리케이션 및 플랫폼 성능 데이터 모두에 대한 가시성을 확보하십시오.
• 경보를 설정하십시오.
• 데이터를 조회 하고 대시보드를 작성하십시오.

로그 전달 사용 안함

로그 전달 기능을 비활성화하려면 Cloudflare Logpush 설명서 의 표준 절차를 따르십시오. New Relic에서는 다른 작업을 수행할 필요가 없습니다.