← Cloudflare Workers / workers / runtime-apis / handlers

Обработчик Tail

tail() обработчик представляет собой обработчик, который вы реализуете при написании Tail Worker. Tail Workers можно использовать для обработки журналов в режиме реального времени и отправки их в сервис журналирования или аналитики.

tail() обработчик вызывается один раз при каждом вызове подключенного Worker-производителя.

Чтобы настроить Tail Worker, см. Документация Tail Workers.

export default {
  async tail(events, env, ctx) {
    fetch("<YOUR_ENDPOINT>", {
      method: "POST",
      body: JSON.stringify(events),
    })
  }
}

from workers import WorkerEntrypoint, fetch
import json

class Default(WorkerEntrypoint):
    async def tail(self, events, env, ctx):
        await fetch("<YOUR_ENDPOINT>", method="POST", body=json.dumps(events))

• events массив

  • Массив TailItems. Один TailItem собирается для каждого события, которое запускает Worker. Для клиентов Workers for Platforms с Tail Worker, установленным на dynamic dispatch Worker, events будет содержать два элемента: один для Worker динамической диспетчеризации и один для пользовательского Worker.

• env объект

  • Объект, содержащий привязки, связанные с вашим Worker, при использовании формат ES modules, например пространства имён KV и Durable Objects.

• ctx объект

  • Объект, содержащий контекст, связанный с вашим Worker, при использовании формат ES modules. В настоящее время этот объект содержит только waitUntil функцию.

• event.type строка

  • Тип события. Всегда возвращает "tail".

• event.traces массив

  • Массив TailItems. Один TailItem собирается для каждого события, которое запускает Worker. Для клиентов Workers for Platforms с Tail Worker, установленным на dynamic dispatch Worker, events будет содержать два элемента: один для Worker динамической диспетчеризации и один для пользовательского Worker.

• event.waitUntil(promisePromise) : void

  • См. waitUntil. Обратите внимание, что в отличие от обработчиков события fetch обработчики tail не возвращают значение, поэтому это единственный способ для trace Workers выполнять асинхронную работу.

• scriptName строка

  • Имя скрипта производителя.

• event объект

  • Содержит сведения о событии, вызвавшем Worker.
    • Для событий fetch: FetchEventInfo объект
    • Для других типов событий: null, в настоящее время.

• eventTimestamp число

  • Измеряется в формате epoch time.

• logs массив

  • Массив TailLogs.

• exceptions массив

  • Массив TailExceptions. Один вызов Worker может привести к нескольким необработанным исключениям, поскольку Worker может регистрировать несколько асинхронных задач.

• outcome строка

  • Результат вызова Worker, один из следующих:
    • unknown: статус результата не был задан.
    • ok: Вызов worker выполнен успешно.
    • exception: Было выброшено необработанное исключение. Это может происходить по разным причинам, включая:
      • Необработанное исключение JavaScript.
      • Обработчик fetch, который не возвращает Response.
      • Внутренняя ошибка.
    • exceededCpu: Вызов Worker превысил лимит CPU.
    • exceededMemory: Вызов Worker превысил лимит памяти.
    • scriptNotFound: Внутренняя ошибка, вызванная сложностью получения скрипта Worker.
    • canceled: Вызов worker был отменён до завершения. Обычно это происходит, когда клиент разрывает соединение до отправки ответа.
    • responseStreamDisconnected: Поток ответа был разорван во время отложенного проксирования. Это происходит, когда клиент или сервер завершает соединение раньше времени.

• request объект

  • A TailRequest объект.

• response объект

  • A TailResponse объект.

• cf объект

  • Содержит данные из IncomingRequestCfProperties.

• headers объект

  • Записи имя/значение заголовка (по умолчанию скрываются). Имена заголовков приводятся к нижнему регистру, а значения повторяющихся заголовков объединяются с помощью строки ", " (запятая с пробелом), чередующиеся, аналогично стандарт Fetch ↗.

• method строка

  • Метод HTTP-запроса.

• url строка

  • URL HTTP-запроса (по умолчанию скрыт).

• getUnredacted() объект

  • Возвращает объект TailRequest с неотредактированными свойствами

Некоторые свойства TailRequest по умолчанию скрываются, чтобы снизить риск случайной записи чувствительной информации, например учётных данных пользователя или API токенов. Скрытие использует эвристические правила, поэтому возможны как ложные срабатывания, так и пропуски. Клиенты могут вызвать getUnredacted() чтобы обойти редактирование данных, однако им всегда следует внимательно относиться к тому, какая информация сохраняется, независимо от того, используется редактирование или нет.

• Скрытие заголовка: значением заголовка будет строка “REDACTED” когда имя заголовка (без учёта регистра) равно cookie/set-cookie или содержит подстроку "auth”, “key”, “secret”, “token”, или "jwt".
• Редактирование URL: для каждой максимально длинной подстроки символов ID (a-z, A-Z, 0-9, '+', '-', '_') в URL, если она соответствует следующим критериям hex- или base-64-идентификатора, эта подстрока заменяется строкой “REDACTED”.
• Hex ID: содержит 32 или более шестнадцатеричных цифр и только шестнадцатеричные цифры и разделители («+», «-», «_»)
• Base-64 ID: содержит 21 символ или более, а также не менее двух заглавных, двух строчных букв и двух цифр.

• status число

  • Код состояния HTTP.

Фиксирует информацию, переданную функциям console.

• timestamp число

  • Измеряется в формате epoch time.

• level строка

  • Строка, указывающая, какая функция console была вызвана. Одно из: debug, info, log, warn, error.

• message объект

  • Массив параметров, передаваемых в функцию console.

Фиксирует необработанное исключение, возникшее при вызове Worker.

• timestamp число

  • Измеряется в формате epoch time.

• name строка

  • Тип ошибки (например,Error, TypeError, и т. д.).

• message объект

  • Описание ошибки (например, "x" is not a function).

• Tail Workers - настройте Tail Worker для получения информации о выполнении других Worker.