← Cloudflare One / cloudflare-one / networks / connectors / cloudflare-tunnel / monitor-tunnels

Потоки журналов

Журналы туннеля записывают всю активность между cloudflared инстансом и глобальной сетью Cloudflare, а также вся активность между cloudflared и вашим исходным сервером. Эти журналы позволяют расследовать проблемы с подключением или производительностью Cloudflare Tunnel. Вы можете настроить сервер для хранения постоянных журналов или транслировать журналы в реальном времени с любого клиентского устройства.

Просмотр журналов на сервере

Если у вас есть доступ к исходному серверу, вы можете использовать --loglevel флаг чтобы включить логирование при запуске туннеля. По умолчанию cloudflared выводит журналы в stdout и не сохраняет их на сервере. При необходимости вы можете использовать --logfile флаг чтобы записывать журналы в файл.

Чтобы включить журналы, Запустите туннель с помощью --loglevel info и --logfile <PATH> флаги. Например,

cloudflared tunnel --loglevel info --logfile cloudflared.log run <UUID>

Просмотр журналов на локальном компьютере

Журналы Cloudflare Tunnel в реальном времени можно просматривать через панель управления или с любой машины, на которой установлен cloudflared установлено. При использовании удалённых потоков журналов не нужно подключаться по SSH к серверу, на котором работает туннель. Чтобы получать удалённые журналы, туннель должен быть активен и способен принимать запросы.

Dashboard

Чтобы транслировать журналы туннеля из панели управления:

В панели управления Cloudflare перейдите в Сеть > Tunnels и выберите свой туннель.
Перейдите в Tunnels ↗
Перейдите в Live logs на вкладке.
Выберите Live чтобы начать трансляцию.

Просмотр журналов реплики

Если вы используете несколько cloudflared экземпляры для одного и того же туннеля (также известного как реплики), журналы со всех подключённых реплик передаются автоматически и группируются по имени хоста, что упрощает определение того, какая хост-машина создала ту или иную запись журнала.

Чтобы отфильтровать поток по определённым репликам, выберите Фильтр значок и разверните Реплики раздел. Также можно отфильтровать по Уровень журнала и Тип события.

CLI

cloudflared демон может передавать журналы любого туннеля в вашей учетной записи в локальную командную строку. cloudflared должен быть установлен как на локальной машине, так и на origin-сервере.

На локальном компьютере пройдите аутентификацию cloudflared в ваш аккаунт Cloudflare:
```
cloudflared tunnel login
```
Запустите cloudflared tail для конкретного туннеля:
```
cloudflared tail <UUID>
```
Чтобы увидеть более структурированное представление JSON-сообщения, можно передать вывод через конвейер в такие инструменты, как jq ↗:
```
cloudflared tail --output=json <UUID> | jq .
```

Фильтруйте журналы

Вы можете фильтровать логи по типу события (--event), уровень события (--level), или частота выборки (-sampling) чтобы уменьшить объём журналов, передаваемых с источника. Это помогает снизить влияние на производительность источника, особенно если источник обычно работает под высокой нагрузкой. Например:

cloudflared tail --level debug <UUID>

Флаг	Описание	Допустимые значения	Значение по умолчанию
`--event`	Фильтруйте по типу события или запроса.	`cloudflared`, `http`, `tcp`, `udp`	Все события
`--level`	Возвращать журналы этого уровня и выше. Работает независимо от `--loglevel` параметр на сервере.	`debug`, `info`, `warn`, `error`, `fatal`	`debug`
`--sampling`	Отберите часть от общего числа журналов.	Число от `0.0` к `1.0`	`1.0`

Просмотр журналов реплики

Если вы используете несколько cloudflared экземпляры для одного и того же туннеля (также известного как реплики), вам нужно указать конкретный экземпляр, из которого будут передаваться журналы:

В панели управления Cloudflare перейдите в Сеть > Tunnels и выберите свой туннель.
Перейдите в Tunnels ↗
Найдите ID Connector для cloudflared экземпляр, который нужно просмотреть.

Укажите Connector ID в cloudflared tail:

cloudflared tail --connector-id <CONNECTOR ID> <UUID>

Особенности производительности

Сессия логирования остаётся открытой не более одного часа. Любая система логирования создаёт определённую дополнительную нагрузку, и это ограничение помогает предотвратить долгосрочное влияние на сквозную задержку вашего туннеля.
При потоковой передаче журналов для туннеля с высокой пропускной способностью Cloudflare намеренно ставит стабильность сервиса выше доставки журналов. Чтобы уменьшить число потерянных записей журнала, попробуйте запрос меньшего количества журналов. Чтобы убедиться, что вы видите все логи, просматривать журналы на сервере вместо удалённой потоковой передачи журналов.