Связаться с намиПодключиться

CDN-ресурс

Статья создана
Обновлена 11 марта 2025 г.

Ресурс — это основная логическая сущность сервиса Yandex Cloud CDN, позволяющая настраивать и управлять распространением контента с источников через CDN.

Чтобы начать распространять контент через CDN, нужно создать ресурс по инструкции, указав в нем:

После создания ресурса в нем также можно настроить:

Доступ к ресурсу можно ограничить с помощью защищенных токенов и политики доступа по IP-адресам.

Можно настроить перенаправление запросов от CDN-ресурса к источнику, изменив URI запроса с помощью правила Rewrite.

Для ресурса в Cloud CDN можно задать дополнительные настройки, которые предоставляются CDN-провайдером EdgeЦентр. Полная функциональность описана в документации API CDN-провайдера. Чтобы включить дополнительные опции, запросите доступ к ним в технической поддержке.

Настройки ресурса начинают действовать через некоторое время после создания или изменения ресурса.

Доменные имена для раздачи контента

Доменные имена для раздачи контента используются в запросах клиентов к CDN-серверам. Например, чтобы файл styles/common.css был доступен по адресу cdn.example.com/styles/common.css, нужно указать доменное имя cdn.example.com.

В Cloud CDN поддерживаются любые доменные имена, в том числе IDN с символами национальных алфавитов не из ASCII, например кириллическими. Такие имена можно указывать в исходном виде (пример.рф) или преобразовывать в Punycode с добавлением префиксов xn-- (xn--e1afmkfd.xn--p1ai). В информации о ресурсе в консоли управления IDN будут отображаться в исходном виде, без преобразования в Punycode.

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

Для корректной работы ресурса у вас должны быть:

  • Права на все указанные доменные имена.

  • Доступ к настройкам DNS для имен.

    Для каждого имени в настройках вашего DNS-хостинга нужно создать CNAME-запись, связывающую это имя с доменным именем CDN-балансировщика вида cl-********.edgecdn.ru. Оно отображается при создании ресурса и на странице уже созданного ресурса в консоли управления. Например, так может выглядеть запись для доменного имени cdn.example.com:

    cdn.example.com. CNAME cl-********.edgecdn.ru

Примечание

Нельзя на одном домене второго уровня иметь и CDN-ресурс, и почтовый сервер. Рекомендуем создать два домена:

  • Для контента, распространяемого через CDN. Обратите внимание, что Cloud CDN следует использовать только с ресурсными записями CNAME, поскольку при использовании записи ANAME конечный пользователь получит ответ, не зависящий от его геолокации. Подробнее о CNAME-записях и их ограничениях см. в RFC-1035.
  • Для легковесного контента и почтового сервера. В этом случае вы можете использовать ресурсные записи ANAME и MX.

Время, требуемое на применение настроек

CDN-ресурс начинает корректно работать через некоторое время после создания или изменения:

  • Новый ресурс начнет корректно работать после того, как запись CNAME, которую вы создали в своем DNS-хостинге (см. раздел о доменных именах для раздачи контента), распространится по серверам DNS. На это может потребоваться несколько часов.

  • Чтобы новые настройки существующего ресурса применились к CDN-серверам, может потребоваться до 15 минут. После этого рекомендуется очистить кеш ресурса.

Статусы ресурса

Ресурс Cloud CDN может быть в одном из статусов:

Для переключения используется опция Доступ конечных пользователей к контенту в основных настройках ресурса.

Если к ресурсу в течение 90 дней нет пользовательских запросов, он переходит в статус Not active.

Статистика использования ресурса

Cloud CDN предоставляет метрики использования ресурса за последние 30 дней:

  • Загружено из источников — объем трафика, загруженного CDN-серверами из источников.
  • Отправлено клиентам — объем трафика, отправленного с CDN-серверов клиентам.
  • Весь трафик — сумма метрик Загружено из источников и Отправлено клиентам.
  • Запросы от клиентов — количество запросов клиентов к CDN.
  • Ответы из кеша — количество запросов клиентов, в ответ на которые CDN-серверы отправили кешированные копии файлов, не запрашивая их у источников (если кеширование на CDN-серверах включено).
  • Ответы с запросами к источникам — количество запросов клиентов, в ответ на которые CDN-серверы не смогли отправить кешированные копии файлов (например, кеширование отключено, файл еще не кешировался сервером или время жизни кеша истекло) и обратились за ними к источникам.
  • Снижение нагрузки на источники — доля трафика, отправленного с CDN-серверов клиентам, за которым не потребовалось обращаться к источникам. Рассчитывается по формуле (1 − (Загружено из источников / Отправлено клиентам)) × 100%.
  • Загружено экранирующим сервером — объем трафика, загруженного экранирующим сервером из источников (если экранирование включено).
  • Ответы с кодами 2xx, 3xx, 4xx, 5xx — количество ответов, отправленных CDN-серверами клиентам, с соответствующими HTTP-кодами состояния.

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

Метрики Monitoring

Cloud CDN автоматически отправляет метрики работы ресурсов в сервис Yandex Monitoring.

Вы можете посмотреть статистику работы на странице ресурса или в интерфейсе Monitoring.

Метрики Cloud CDN обновляются в среднем раз в 3 минуты.

Примечание

Из-за технических особенностей метрики от CDN-провайдера EdgeЦентр экспортируются из Yandex Monitoring в формате Prometheus с задержкой, значения времени в метриках сдвинуто на 10–15 минут вперед относительно их реального значения. Например, значение метрики, выгруженной в формате Prometheus, для 01:00 будет соответствовать реальному значению в промежутке от 00:45 до 00:50.

При просмотре метрик в интерфейсе Monitoring временные значения метрик соответствуют реальным.

Список метрик, передаваемых в Monitoring, представлен в справочнике.

Примеры использования

См. также

Предыдущая
Обзор сервиса
Следующая
Источники и их группы