Cloudflare Logpush

Cloudflare Logpush는 HTTP 요청 로그를 Ahrefs로 자동 전송합니다. 트래픽이 많은 사이트에 권장되는 방법이지만, Cloudflare 엔터프라이즈 플랜이 필요합니다.

사전 준비 사항

• 모니터링하려는 Zone에 Cloudflare 엔터프라이즈 플랜이 있어야 합니다.
• 다음 권한이 있는 Cloudflare API 토큰:
  • 영역 → 영역 → 읽기
  • Zone → Logs → Edit

Cloudflare API 토큰 가져오기

올바른 계정으로 Cloudflare 대시보드에 로그인되어 있는지 확인하세요. 그런 다음 https://dash.cloudflare.com/profile/api-tokens 페이지로 이동해 오른쪽 상단의 토큰 만들기 버튼을 찾아 클릭하세요:

이제 사용자 지정 토큰 생성 흐름을 진행하세요:

다음 정보를 입력하세요:

• API 토큰 이름: ahrefs-bot-analytics
• 다음 권한을 부여하세요:
  • Ahrefs Bot Analytics로 로그를 푸시하는 Logpush 작업을 구성하려면 Zone / Logs / Edit로 이동합니다.
  • 구성할 영역을 찾을 수 있도록 Zone / Zone / Read
• Zone Resources는 Include / All Zones로 설정할 수 있으며, 또는 웹사이트 도메인에 해당하는 영역을 선택할 수도 있습니다.

이제 Continue to summary 버튼을 클릭하세요. 요약은 다음과 같이 표시됩니다:

이제 Create Token 버튼을 클릭하고, 생성된 토큰을 다음 단계에서 사용할 수 있도록 클립보드에 복사하세요.

추가 정보는 Cloudflare 문서의 API 토큰 생성 방법을 참고하세요.

자동 설정

1. Ahrefs에서 프로젝트 설정 → Bot Analytics로 이동합니다.
2. 방법으로 Cloudflare Logpush를 선택합니다.
3. Cloudflare API 토큰을 붙여넣고 Connect를 클릭합니다.

Ahrefs는 토큰을 사용하여 다음 작업을 수행합니다:

1. 프로젝트의 도메인과 일치하는 Zone을 찾습니다.
2. 기존 Logpush 작업 확인.
3. Ahrefs로 로그를 보내는 새 작업을 만듭니다.

수동 설정

API 토큰을 제공하고 싶지 않다면 Cloudflare API를 사용해 Logpush 작업을 수동으로 설정할 수 있습니다.

1단계 — Zone ID 및 API 토큰 가져오기

1. Cloudflare 대시보드로 이동하여 웹사이트의 도메인을 선택합니다.

2. 오른쪽 사이드바에서 아래로 스크롤하여 API 섹션에서 Zone ID를 찾습니다.

3. "API 토큰 받기"를 클릭한 다음, 다음 권한으로 새 토큰을 생성합니다.

   • 영역 → 영역 → 읽기
   • Zone → Logs → Edit

   자세한 안내는 API 토큰 얻기를 참고하세요.

2단계 — Logpush 작업 만들기

$ZONE_ID와 $CF_TOKEN이 준비되면 다음 명령어를 실행합니다. 프로젝트 세부 정보가 미리 입력된 정확한 명령어는 프로젝트 설정 → Bot Analytics → 수동으로 설정에서 확인할 수 있습니다.

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/logpush/jobs" \
  -X POST \
  -H "Authorization: Bearer $CF_TOKEN" \
  --data-binary '{
  "name": "ahrefs-web-analytics-http-requests",
  "destination_conf": "https://analytics.ahrefs.com/api/cf_logpush/http_requests?header_x-ahrefs-web-analytics-property=YOUR_PROPERTY_KEY",
  "dataset": "http_requests",
  "frequency": "high",
  "filter": "{\"where\":{\"or\":[{\"key\":\"ClientRequestHost\",\"operator\":\"eq\",\"value\":\"yourwebsite.com\"},{\"key\":\"ClientRequestHost\",\"operator\":\"endsWith\",\"value\":\".yourwebsite.com\"}]}}",
  "output_options": {
    "field_names": [
      "ClientIP", "ClientRequestMethod", "ClientRequestHost",
      "ClientRequestProtocol", "ClientRequestScheme", "ClientRequestURI",
      "ClientRequestPath", "ClientRequestUserAgent", "ClientRequestReferer",
      "EdgeStartTimestamp", "EdgeEndTimestamp", "EdgeResponseStatus",
      "EdgeResponseBytes", "EdgeResponseContentType",
      "EdgeTimeToFirstByteMs", "ClientCountry", "ClientCity", "ClientASN",
      "ClientDeviceType", "ClientRegionCode", "BotScore", "BotScoreSrc",
      "BotTags", "VerifiedBotCategory", "RayID"
    ],
    "timestamp_format": "unixnano"
  },
  "enabled": true
}'

3단계 — 연결 확인

작업을 만든 후 Ahrefs의 프로젝트 설정 → 봇 애널리틱스로 돌아가서 상태 확인을 클릭해 데이터가 수신되고 있는지 확인하세요.