> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axottle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Наблюдаемость CDN

> Статусы аккаунтов, операций и ресурсов, справочник кодов ошибок и журнал операций.

За CDN можно следить на четырёх уровнях: аккаунт провайдера, операция провижининга, ресурс и статус CDN-блока в графе Connection Unit. Все ошибки приходят с машиночитаемым кодом — по нему легко понять, что случилось и что делать.

<Info>Для кого: администратор панели, SRE. Требуемые права: чтение CDN и Connection Units.</Info>

## Уровни статусов

| Уровень  | Где смотреть         | Что показывает                                                                                                                    |
| -------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| CDN-блок | Граф Connection Unit | `applying` / `verifying` / `ready` / `blocked` / `failed` / `draft` + идентификатор операции, домен доставки, код и текст ошибки. |

Дополнительно:

* Свидетельства проверок (пробы) записываются на каждый прогон верификации и устаревают через 12 часов — статус «готов» всегда опирается на свежие проверки.
* Интеграции Cloudflare AutoDNS имеют собственный статус (`unchecked` / `verified` / `failed`) с временем и сообщением последнего теста.

## Журнал операций

* Действия интеграции Cloudflare AutoDNS (создание, обновление, удаление, тесты, публикация записей — и успехи, и неудачи) записываются в Журнал операций панели (аудит-лог).

## Справочник кодов ошибок

Коды ниже показываются оператору в статусе операции и CDN-блока.

| Код                              | Что означает                                                                                                                                                        | Что делать                                                                                                                        |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `CDN_AUTOMATION_NOT_AVAILABLE`   | Нет подключённого аккаунта, готового к автоматическому использованию; либо в Connection Unit больше одного CDN-блока; либо у аккаунта не заполнены ключи/Folder ID. | Подключите и проверьте аккаунт Yandex Cloud; оставьте один CDN-блок; заполните учётные данные.                                    |
| `CDN_BLOCK_ENTRY_NODE_REQUIRED`  | CDN-блок не соединён ровно с одним входной нодой.                                                                                                                   | Исправьте граф: шлюз → CDN-блок → одну входную ноду с доменом.                                                                    |
| `ORIGIN_DNS_FAILED`              | У входной ноды нет домена, либо не удаётся вывести домен доставки.                                                                                                  | Назначьте ноде домен и повторите применение.                                                                                      |
| `ORIGIN_TLS_FAILED`              | Предварительная HTTPS-проверка origin не прошла: на ноде нет валидного сертификата.                                                                                 | Настройте валидный TLS на ноде, затем повторите применение.                                                                       |
| `AUTH_INVALID`                   | Аутентификация у провайдера с сохранёнными ключами не удалась.                                                                                                      | Обновите ключи в аккаунте и нажмите **Проверить ключи**.                                                                          |
| `CDN_DOMAIN_SETUP_FAILED`        | Аккаунт не может читать DNS-зоны, либо ни одна зона не покрывает домен ноды.                                                                                        | Выдайте аккаунту доступ к DNS (`dns.editor`) и убедитесь, что зона домена ноды существует у провайдера.                           |
| `CERTIFICATE_ISSUE_FAILED`       | Запрос управляемого TLS-сертификата завершился ошибкой.                                                                                                             | Проверьте права `certificate-manager.editor` и DNS-зону; повторите применение.                                                    |
| `CERTIFICATE_VALIDATION_PENDING` | Сертификат не выпущен за отведённое время ожидания.                                                                                                                 | Подождите и повторите применение; проверьте, что DNS-валидация сертификата может пройти в зоне.                                   |
| `DNS_RECORD_CONFLICT`            | Не удалось опубликовать DNS-challenge или CNAME домена доставки.                                                                                                    | Найдите и уберите конфликтующие записи в зоне, затем повторите применение.                                                        |
| `DNS_PROPAGATION_TIMEOUT`        | Запись опубликована, но не стала видна на авторитетных серверах за время ожидания.                                                                                  | Проверьте зону и делегирование; повторите применение позже.                                                                       |
| `PROVIDER_SCHEMA_MISMATCH`       | Провайдер отклонил создание origin-группы или ресурса.                                                                                                              | Повторите применение; при повторении ошибки — обратитесь в поддержку.                                                             |
| `PROVIDER_OPERATION_TIMEOUT`     | Провайдер так и не вернул CNAME для домена доставки.                                                                                                                | Повторите применение позже; проверьте статус сервиса провайдера.                                                                  |
| `CACHE_BYPASS_UNPROVEN`          | Повторные проверочные запросы вернули одинаковые ответы — не доказано, что CDN не кэширует.                                                                         | Убедитесь, что кэширование в ресурсе выключено; повторное применение перепроверит.                                                |
| `NEEDS_QUALIFICATION`            | У провайдера нет квалифицированного адаптера, либо функциональные пробы не прошли; блок в статусе `blocked`.                                                        | Для кандидатов — используйте Yandex Cloud или ручной режим. Для проб — устраните причину и повторите применение.                  |
| `UNKNOWN_MUTATION_RESULT`        | Аренда домена доставки существует без привязки — состояние требует сверки администратором.                                                                          | Не пересоздавайте блок вслепую; разберите состояние вручную, при необходимости — с поддержкой.                                    |
| `ROLLBACK_PARTIAL`               | Часть шагов отката не выполнилась; операция помечена как требующая внимания.                                                                                        | В ответе перечислены незавершённые пункты — доделайте их вручную, см. <a href="/ru/cdn/troubleshooting">Устранение неполадок</a>. |

Ошибки уровня аккаунта и интеграций:

| Симптом                                     | Что означает                                                            | Что делать                                                   |
| ------------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------ |
| Аккаунт `permission_limited`                | Ключи аутентифицируются, но не хватает ролей (список показан в панели). | Выдайте недостающие роли и перепроверьте ключи.              |
| Удаление аккаунта → HTTP 409                | На аккаунт ссылаются CDN-ресурсы.                                       | Заархивируйте аккаунт или сначала деинсталлируйте CDN-блоки. |
| Cloudflare: 401/403                         | Токен недействителен или без прав Zone.DNS.                             | Пересоздайте токен с правом редактирования DNS зоны.         |
| Cloudflare: запись не создаётся, ошибки нет | Ни одна интеграция не покрывает домен ноды — пропуск по дизайну.        | Добавьте интеграцию с подходящим корневым доменом.           |

## Проверка

Связанные страницы: <a href="/ru/cdn/resources-and-operations">Ресурсы и операции</a>, <a href="/ru/cdn/troubleshooting">Устранение неполадок</a>.

<Note>Проверено для версии Axottle текущей ветки. Дата проверки: 2026-07-11.</Note>
