← Cloudflare Logs / logs / logpush / logpush-job / enable-destinations

Включите New Relic

Cloudflare Logpush поддерживает отправку журналов напрямую в New Relic через панель управления Cloudflare или API.

1. На панели управления Cloudflare перейдите к разделу Logpush на уровне аккаунта или домена (также называемого зоной).

   Для аккаунта: Перейдите в Logpush ↗

   Для домена (также называемого зоной): Перейдите в Logpush ↗

2. В зависимости от выбора вам доступны наборы данных уровня аккаунта и наборы данных, привязанные к зоне, соответственно.

3. Выберите Создание задания Logpush.

4. В Выберите пункт назначения, выберите New Relic.

5. Введите New Relic Logs Endpoint:

Используйте регион, соответствующий региону, настроенному в вашей учётной записи New Relic. Лицензионный ключ можно найти в dashboard New Relic. Получить его можно, выполнив эти шаги ↗.

Когда вы закончите вводить данные получателя, выберите Продолжение.

6. Выберите набор данных для отправки в хранилище.

7. На следующем шаге настройте задание Logpush:

   • Введите Название задания.
   • В разделе Если журналы соответствуют, вы можете выбрать, какие события включить в журналы или исключить из них. См. Фильтры с дополнительной информацией. Эта опция доступна не для всех наборов данных.
   • В Отправьте следующие поля, вы можете либо отправлять в хранилище назначения все журналы, либо выбирать, какие журналы отправлять.

8. В Advanced Options, вы можете:

   • Выберите формат полей отметки времени в своих журналах (RFC3339 (по умолчанию), Unix, или UnixNano).
   • Выберите частота сэмплирования для ваших журналов или отправлять случайно выбранный процент журналов.
   • Включите скрытие данных для CVE-2021-44228. Эта опция заменит каждое вхождение ${ с x{.

9. Выберите Отправить после того как настройка задания Logpush завершена.

Убедитесь Log Share разрешения включены, прежде чем пытаться читать или настраивать задание Logpush. Дополнительные сведения см. в Раздел Roles.

Чтобы создать задание, выполните POST запрос к конечной точке заданий Logpush со следующими полями:

• имя (необязательно) - Используйте имя своего домена в качестве имени задания.

• output_options (необязательно) - Чтобы настроить поля, частоту выборки и формат временной метки, см. Параметры вывода журнала.

• destination_conf - Получатель журналов, состоящий из URL эндпойнта, лицензионного ключа и формата в формате строки ниже.

  • <NR_ENDPOINT_URL>: Конечная точка приема HTTP-логов New Relic, которой является https://log-api.newrelic.com/log/v1 для США или https://log-api.eu.newrelic.com/log/v1 для EU, в зависимости от региона, настроенного в вашей учетной записи New Relic.

  • <NR_LICENSE_KEY>: Этот ключ можно найти на панели управления New Relic. Получить его можно, перейдя по эти шаги ↗.

  • format: Формат: cloudflare.

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

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

• max_upload_records (необязательно) - Максимальное количество строк журнала на пакет. Значение должно составлять не менее 1,000 строк. Указать минимальное количество строк на пакет нельзя, поэтому файлы журналов могут содержать значительно меньше строк, чем указано.

• max_upload_bytes (необязательно) - Максимальный несжатый размер файла пакета журналов. Значение должно составлять не менее 5 MB. Задать минимальный размер файла нельзя, поэтому файлы журналов могут быть значительно меньше этого размера пакета. Тем не менее рекомендуется задавать этот параметр равным 5,000,000.

• dataset - Категория журналов, которые вы хотите получать. См. Наборы данных для полного списка поддерживаемых наборов данных.

Пример запроса с использованием cURL:

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/logpush/jobs" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"name": "<DOMAIN_NAME>",
		"output_options": {
				"field_names": [
						"ClientIP",
						"ClientRequestHost",
						"ClientRequestMethod",
						"ClientRequestURI",
						"EdgeEndTimestamp",
						"EdgeResponseBytes",
						"EdgeResponseStatus",
						"EdgeStartTimestamp",
						"RayID"
				],
				"timestamp_format": "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
	}'

Ответ:

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

См. Управлять Logpush с помощью cURL чтобы обновить задание (включая включение и отключение).