# Передача событий Yandex Cloud Postbox в Yandex Data Streams и их анализ с помощью Yandex DataLens


{% note warning %}

Часть ресурсов, необходимых для прохождения практического руководства, доступны только в [регионе Россия](../../overview/concepts/region.md).

{% endnote %}


В этом руководстве вы настроите передачу событий [Yandex Cloud Postbox](../../postbox/index.md) в [Yandex Data Streams](../../data-streams/index.md) и визуализацию этих событий с помощью [Yandex DataLens](../../datalens/index.md) для последующего анализа. Источник событий — отправка электронных писем.

Реализовать предлагаемое решение можно с помощью [консоли управления](https://kz.console.yandex.cloud) Yandex Cloud, даже не имея навыков разработки. Для обработки и хранения данных будут использоваться сервисы [Yandex Cloud Functions](../../functions/index.md) и [Yandex Managed Service for YDB](../../ydb/index.md).

Чтобы настроить передачу событий и их визуализацию:

1. [Подготовьте облако к работе](#before-begin).
1. [Создайте сервисные аккаунты](#service-accounts).
1. [Создайте статический ключ доступа](#static-key).
1. [Настройте базу данных Managed Service for YDB](#ydb).
1. [Создайте поток данных Data Streams](#stream).
1. [Подготовьте ресурсы Yandex Cloud Postbox](#postbox).
1. [Подготовьте ресурсы Cloud Functions](#serverless-functions).
1. [Отправьте письма](#send-letters).
1. [Настройте визуализацию в DataLens](#datalens).

Если созданные ресурсы вам больше не нужны, [удалите их](#clear-out).


## Подготовьте облако к работе {#before-begin}

Зарегистрируйтесь в Yandex Cloud и создайте [платежный аккаунт](../../billing/concepts/billing-account.md):
1. Перейдите в [консоль управления](https://kz.console.yandex.cloud), затем войдите в Yandex Cloud или зарегистрируйтесь.
1. На странице **[Yandex Cloud Billing](https://kz.console.yandex.cloud/billing)** убедитесь, что у вас подключен платежный аккаунт, и он находится в [статусе](../../billing/concepts/billing-account-statuses.md) `ACTIVE` или `TRIAL_ACTIVE`. Если платежного аккаунта нет, [создайте его](../../billing/quickstart/index.md) и [привяжите](../../billing/operations/pin-cloud.md) к нему облако.

Если у вас есть активный платежный аккаунт, вы можете создать или выбрать [каталог](../../resource-manager/concepts/resources-hierarchy.md#folder), в котором будет работать ваша инфраструктура, на [странице облака](https://kz.console.yandex.cloud/cloud).

[Подробнее об облаках и каталогах](../../resource-manager/concepts/resources-hierarchy.md).


### Необходимые платные ресурсы {#paid-resources}

В стоимость поддержки инфраструктуры входят:

* плата за операции с YDB и хранение данных ([тарифы Yandex Managed Service for YDB](../../ydb/pricing/serverless.md));
* плата за хранение данных Data Streams ([тарифы Yandex Data Streams](../../data-streams/pricing.md));
* плата за количество вызовов функции, вычислительные ресурсы, выделенные для выполнения функции, и исходящий трафик ([тарифы Cloud Functions](../../functions/pricing.md));
* плата за использование Yandex Cloud Postbox ([тарифы Yandex Cloud Postbox](../../postbox/pricing.md));
* плата за тариф DataLens ([тарифы Yandex DataLens](../../datalens/pricing.md)).


## Создайте сервисные аккаунты {#service-accounts}

Создайте два [сервисных аккаунта](../../iam/concepts/users/service-accounts.md):

* `yds-functions` — от его имени будет вызываться [функция](../../functions/concepts/function.md) Cloud Functions и будут записываться данные в [базу данных](../../ydb/concepts/resources.md#database) YDB;
* `postbox-user` — от его имени будут отправляться письма через Yandex Cloud Postbox.

1. Создайте сервисный аккаунт `yds-functions`:

    {% list tabs group=instructions %}

    - Консоль управления {#console}

      1. В [консоли управления](https://kz.console.yandex.cloud) выберите [каталог](../../resource-manager/concepts/resources-hierarchy.md#folder), в котором вы будете создавать инфраструктуру.
      1. Перейдите в сервис **Identity and Access Management** и нажмите кнопку **Создать сервисный аккаунт**.
      1. В поле **Имя** укажите имя `yds-functions`.
      1. Нажмите кнопку ![image](../../_assets/console-icons/plus.svg) **Добавить роль** и выберите [роли](../../iam/concepts/access-control/roles.md) `yds.editor` и `functions.functionInvoker`.
      1. Нажмите кнопку **Создать**.

    {% endlist %}

1. Аналогичным образом создайте сервисный аккаунт `postbox-user` и назначьте ему [роль](../../postbox/security/index.md#postbox-sender) `postbox.sender`.

## Создайте статический ключ доступа {#static-key}

Создайте [статический ключ доступа](../../iam/concepts/authorization/access-key.md), который будет использоваться для отправки писем:

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором вы создаете инфраструктуру.
  1. Перейдите в сервис **Identity and Access Management** и в списке сервисных аккаунтов выберите `postbox-user`. В открывшемся окне:

      1. На панели сверху нажмите кнопку ![plus](../../_assets/console-icons/plus.svg) **Создать новый ключ** и выберите **Создать статический ключ доступа**.
      1. Нажмите кнопку **Создать**.
      1. Сохраните идентификатор и секретный ключ.

          {% note alert %}

          После закрытия диалога значение ключа будет недоступно.

          {% endnote %}

{% endlist %}


## Настройте базу данных Managed Service for YDB {#ydb}

В качестве хранилища событий может использоваться любая подходящая для задач аналитики СУБД. В данном руководстве используется [бессерверная база данных](../../ydb/concepts/resources.md#serverless) Managed Service for YDB. Для других СУБД SQL-запрос создания таблицы и код функции загрузки событий в нее могут отличаться.


### Создайте базу данных {#create-db}

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором вы создаете инфраструктуру.
  1. Перейдите в сервис **Managed Service for YDB** и нажмите кнопку **Создать базу данных**.
  1. В поле **Имя** укажите `postbox-events-ydb`.
  1. В поле **Тип базы данных** выберите `Serverless`.
  1. Другие параметры базы данных оставьте без изменений и нажмите кнопку **Создать базу данных**.

  Дождитесь запуска БД. В процессе создания база данных будет находиться в статусе `Provisioning`, а когда станет готова к использованию, ее статус изменится на `Running`.

{% endlist %}


### Создайте таблицу {#create-table}

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. На странице **Базы данных** выберите вновь созданную БД `postbox-events-ydb`.
  1. Чтобы открыть корневую директорию БД, перейдите на вкладку ![image](../../_assets/console-icons/folder.svg) **Навигация**.
  1. Чтобы создать запрос к БД, в правом верхнем углу нажмите кнопку **Новый SQL-запрос**.
  1. В открывшемся поле **Запрос** введите:

      ```sql
      CREATE TABLE postbox_events
      (
          saved_datetime Datetime NOT NULL,
          eventid String NOT NULL,
          eventtype String,
          mail_timestamp Timestamp,
          mail_messageid String,
          mail_ch_from String,
          mail_ch_to String, 
          mail_ch_messageid String,
          mail_ch_subject String,
          delivery_timestamp Timestamp,
          delivery_time_ms Uint64,
          delivery_recipients String,
          bounce_bounceType String,
          bounce_bounceSubType String,
          bounce_bouncedRecipients String,
          bounce_timestamp Timestamp,
          -- message Json,
          PRIMARY KEY (saved_datetime, eventid)
      )
      ```

  1. Нажмите кнопку ![image](../../_assets/console-icons/play-fill.svg) **Выполнить**.

      В результате выполнения запроса в базе данных появится новая таблица `postbox_events`.

{% endlist %}


## Создайте поток данных Data Streams {#stream}

Создайте [поток данных](../../data-streams/concepts/glossary.md#stream-concepts), в котором будут регистрироваться события Yandex Cloud Postbox:

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором вы создаете инфраструктуру.
  1. Перейдите в сервис **Data Streams** и нажмите кнопку **Создать поток**.
  1. В поле **База данных** выберите созданную ранее базу данных `postbox-events-ydb`.
  1. В поле **Имя** укажите имя потока данных `postbox-events-stream`.
  1. В поле **Режим тарификации** выберите `По фактическому использованию`.
  1. Другие параметры потока данных оставьте без изменений и нажмите кнопку **Создать**.

{% endlist %}

Дождитесь запуска потока данных. Когда поток станет готов к использованию, его статус изменится с `Creating` на `Active`.


## Подготовьте ресурсы Yandex Cloud Postbox {#postbox}

В сервисе Yandex Cloud Postbox настройте [конфигурацию](../../postbox/concepts/glossary.md#subscription) для регистрации событий в Data Streams, создайте [адрес](../../postbox/concepts/glossary.md#adress) для отправки писем и [пройдите](../../postbox/operations/check-domain.md) проверку прав на домен.


### Создайте конфигурацию Yandex Cloud Postbox {#config}

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором вы создаете инфраструктуру.
  1. Перейдите в сервис **Cloud Postbox**.
  1. На панели слева выберите ![image](../../_assets/console-icons/list-ul.svg) **Конфигурации** и нажмите кнопку **Создать конфигурацию**.
  1. В поле **Имя** укажите имя конфигурации `postbox-events-config`.
  1. В блоке **Подписки** нажмите кнопку **Добавить** и в появившейся форме:

      1. В поле **Название** укажите название [подписки](../../postbox/concepts/glossary.md#subscription) `postbox-events-subscribe`.
      1. В поле **Поток данных** выберите [поток данных](../../data-streams/concepts/glossary.md#stream-concepts) `postbox-events-stream`.
      1. Включите опцию **Включено**, чтобы активировать подписку.

  1. Другие параметры конфигурации оставьте без изменений и нажмите кнопку **Создать конфигурацию**.

{% endlist %}


### Создайте адрес Yandex Cloud Postbox {#address}

1. На вашем компьютере сгенерируйте ключ `privatekey.pem` для создания DKIM-подписи. Для этого в терминале выполните команду:

    ```bash
    openssl genrsa -out privatekey.pem 2048
    ```

    {% note info %}

    В операционных системах Linux и macOS утилита `openssl` предустановлена. В Windows эту утилиту необходимо предварительно установить. Подробнее на [сайте](https://openssl-library.org/) проекта.

    {% endnote %}

1. Создайте адрес Yandex Cloud Postbox:

    {% list tabs group=instructions %}

    - Консоль управления {#console}

      1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором вы создаете инфраструктуру.
      1. Перейдите в сервис **Cloud Postbox**.
      1. На панели слева выберите ![at](../../_assets/console-icons/at.svg) **Адреса** и нажмите кнопку **Создать адрес**.
      1. В поле **Домен** укажите домен, с которого вы будете отправлять письма. Домен может быть любого уровня и должен принадлежать вам.
      1. В поле **Селектор** укажите селектор, например `postbox`. Указанный селектор должен использоваться только в одной ресурсной записи — той, которую необходимо создать при прохождении [проверки прав на домен](#domain).
      1. В поле **Конфигурация** выберите созданную ранее конфигурацию `postbox-events-config`.
      1. В поле **Приватный ключ** вставьте содержимое файла приватного ключа `privatekey.pem`, созданного на предыдущем шаге.
      1. Другие параметры адреса оставьте без изменений и нажмите кнопку **Создать адрес**.
      1. В открывшемся списке адресов нажмите на строку с вновь созданным адресом.
      1. На странице с информацией об адресе в блоке **Подтверждение подписи** из поля **Значение** скопируйте и сохраните значение [TXT-записи](../../dns/concepts/resource-record.md#txt).

    {% endlist %}


### Пройдите проверку владения доменом {#domain}

Чтобы отправлять письма, подтвердите владение доменом. После создания адреса на его странице сформируются настройки DKIM-подписи. Их нужно указать в качестве значений [ресурсных записей](../../glossary/dns.md#dns-server), которые необходимо добавить в вашу доменную зону. Вы можете добавить записи у вашего регистратора или в сервисе [Yandex Cloud DNS](../../dns/index.md), если вы делегировали ваш домен Yandex Cloud.

{% list tabs group=dkim %}

- Простая настройка {#easy}

    При простой настройке Yandex Cloud Postbox самостоятельно генерирует ключи DKIM. На странице адреса в блоке **Настройка подписи писем (DKIM)** отображаются две CNAME-записи, которые нужно добавить в DNS-провайдер.

    **Пример создания ресурсных записей в Yandex Cloud DNS**

    1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором находятся адрес и ваша доменная зона.
    
       Если у вас еще нет [публичной зоны](../../dns/concepts/dns-zone.md#public-zones) DNS, [создайте](../../dns/operations/zone-create-public.md) ее.
    1. Перейдите в сервис **Cloud Postbox**.
    1. Выберите созданный адрес и откройте блок **Настройка подписи писем (DKIM)**.
    1. Для каждой из двух CNAME-записей выполните следующие шаги:
    
        1. Перейдите в сервис **Cloud DNS**.
        1. Выберите вашу доменную зону.
        1. Нажмите кнопку **Создать запись**.
        1. В поле **Тип** выберите `CNAME`.
        1. В поле **Имя** скопируйте имя записи из блока **Настройка подписи писем (DKIM)** на странице адреса (без домена).
    
           {% note info %}
    
           Для других DNS-сервисов может потребоваться скопировать имя записи целиком, включая домен.
    
           {% endnote %}
    
        1. В поле **Значение** скопируйте значение записи из блока **Настройка подписи писем (DKIM)** на странице адреса.
        1. В поле **TTL (в секундах)** укажите время жизни записи.
        1. Нажмите кнопку **Создать**.
    1. Перейдите в сервис **Cloud Postbox**.
    1. Выберите созданный адрес.
    1. Дождитесь, когда Yandex Cloud Postbox проверит настройки DKIM-подписи. Если записи верны, статус проверки на странице адреса изменится на `Success`.

- Расширенная настройка {#advanced}

    При расширенной настройке вы самостоятельно [генерируете ключ](../../postbox/operations/create-address.md) для создания DKIM-подписи. На странице адреса в блоке **Настройка подписи писем (DKIM)** отображается одна TXT-запись, которую нужно добавить в DNS-провайдер.

    **Пример создания ресурсных записей в Yandex Cloud DNS**
    
    1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором находятся адрес и ваша доменная зона.

        Если у вас еще нет [публичной зоны](../../dns/concepts/dns-zone.md#public-zones) DNS, [создайте](../../dns/operations/zone-create-public.md) ее.
    1. Перейдите в сервис **Cloud DNS**.
    1. Выберите вашу доменную зону.
    1. Нажмите кнопку **Создать запись**.
    1. В поле **Имя** укажите часть имени, сгенерированного при создании адреса, без домена в формате `<селектор>._domainkey`. Например `postbox._domainkey`.

        {% note info %}

        Для других DNS-сервисов может потребоваться скопировать запись целиком. Итоговая запись должна иметь вид `<селектор>._domainkey.<домен>.`, например `postbox._domainkey.example.com.`.

        {% endnote %}

    1. В поле **Тип** выберите `TXT`.
    1. В поле **Значение** скопируйте содержимое поля **Значение** из блока **Настройка подписи писем (DKIM)** необходимого адреса. Обратите внимание, что значение записи нужно взять в кавычки, например:

        ```text
        "v=DKIM1;h=sha256;k=rsa;p=M1B...aCA8"
        ```

        {% note info %}

        В других DNS-сервисах могут быть другие требования к оформлению ресурсных записей. Подробнее читайте в документации того DNS-сервиса, в котором создаете ресурсную запись.

        {% endnote %}

    1. В поле **TTL (в секундах)** укажите время жизни записи.
    1. Нажмите кнопку **Создать**.
    1. Перейдите в сервис **Cloud Postbox**.
    1. Выберите созданный адрес.
    1. Дождитесь, когда Yandex Cloud Postbox проверит настройки DKIM-подписи. Если запись верна, статус проверки на странице адреса изменится на `Success`.

{% endlist %}

Ответы DNS-сервера кешируются, поэтому возможны задержки при обновлении ресурсной записи. Если статус проверки не изменится в течение 24 часов, нажмите кнопку **Запустить проверку**.


## Подготовьте ресурсы Cloud Functions {#serverless-functions}

Создайте [функцию](../../functions/concepts/function.md) для отправки данных из потока данных в БД, а также [триггер](../../functions/concepts/trigger/index.md), который будет вызывать функцию при регистрации событий в потоке данных.


### Получите код функции {#code}

{% list tabs %}

- Архив

  [Скачайте](https://github.com/yandex-cloud-examples/yc-postbox-events/raw/main/build/postbox-events.zip) архив `postbox-events.zip` на свой компьютер. В архиве находятся файлы `index.py` и `requirements.txt`, содержащие код функции.

- Репозиторий

  На своем компьютере выполните следующие операции:

  1. Склонируйте [репозиторий](https://github.com/yandex-cloud-examples/yc-postbox-events/tree/main) с кодом функции:

      ```bash
      git clone https://github.com/yandex-cloud-examples/yc-postbox-events/blob/main/build/postbox-events.git
      ```

      Перейдите в директорию с репозиторием. В ней должны появиться файлы `index.py` и `requirements.txt`, содержащие код функции.

  1. Создайте архив с именем `postbox-events.zip` и добавьте в него файлы `index.py` и `requirements.txt`.

{% endlist %}


### Получите реквизиты для подключения к БД {#db-details}

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором вы создаете инфраструктуру.
  1. Перейдите в сервис **Managed Service for&nbsp;YDB**.
  1. Выберите базу данных, для которой нужно получить эндпоинт и путь.

      * Эндпоинт БД указан в блоке **Соединение** в первой части значения поля **Эндпоинт** (часть до вхождения `/?database=`):

          >Например, эндпоинт для БД в режиме Serverless — `grpcs://ydb.serverless.yandexcloud.net:2135`.

      * Путь БД указан в блоке **Соединение** во второй части значения поля **Эндпоинт** (часть после вхождения `/?database=`).

          >Пример пути БД: `/ru-central1/b1gia87mbaom********/etnudu2n9ri3********`.

{% endlist %}


### Создайте функцию {#function}

Для создания функции вам потребуется код функции и реквизиты для подключения к БД.

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором вы создаете инфраструктуру.
  1. Перейдите в сервис **Cloud Functions**.
  1. Создайте функцию:

      1. Нажмите кнопку **Создать функцию**.
      1. В поле **Имя** введите имя функции. Например, `postbox-events-function`.
      1. Нажмите кнопку **Создать**.

  1. Создайте версию функции:

      1. В открывшемся окне **Редактор** выберите `Python 3.14`.
      1. Отключите опцию **Добавить файлы с примерами кода**.
      1. Нажмите кнопку **Продолжить**.
      1. В поле **Источник кода** выберите `ZIP-архив`.
      1. Нажмите кнопку **Прикрепить файл** и выберите архив `postbox-events.zip`.
      1. В поле **Точка входа** укажите `index.handler`.

      1. В блоке **Параметры** укажите:

          * **Таймаут** — `10 секунд`.
          * **Память** — `128 МБ`.
          * **Сервисный аккаунт** — `yds-functions`.
          * **Переменные окружения**:

              Ключ | Описание | Пример значения
              :--- | :--- | :---
              `YDB_DATABASE` | Путь БД     | `/kz1/b1go123e9vjq********/etnu15kr22********`
              `YDB_ENDPOINT` | Эндпоинт БД | `grpcs://ydb.serverless.yandexcloud.net:2135`
              `YDB_TABLE`    | Имя таблицы | `postbox_events`

      1. Нажмите кнопку **Сохранить изменения**.

{% endlist %}


### Создайте триггер {#trigger}

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором вы создаете инфраструктуру.
  1. Перейдите в сервис **Cloud Functions**.
  1. На панели слева выберите ![image](../../_assets/console-icons/gear-play.svg) **Триггеры** и нажмите кнопку **Создать триггер**.
  1. В поле **Имя** введите имя триггера `postbox-events-trigger`.
  1. В поле **Тип** выберите `Data Streams`.
  1. В поле **Запускаемый ресурс** выберите `Функция`.
  1. В блоке **Настройки Data Streams** выберите поток данных `postbox-events-stream` и сервисный аккаунт `yds-functions`.
  1. В блоке **Настройки функции** выберите функцию `postbox-events-function` и сервисный аккаунт `yds-functions`.
  1. Нажмите кнопку **Создать триггер**.

{% endlist %}


## Отправьте письма {#send-letters}

1. Удобным вам способом [отправьте](../../postbox/operations/send-email.md#send-email) несколько тестовых писем с использованием адреса Yandex Cloud Postbox и статического ключа доступа, созданных ранее.
1. Убедитесь, что письма доставлены. Для этого проверьте почту, на которую вы отправляли эти письма.
1. Убедитесь, что данные об отправке писем поступают в сервисы:

    {% list tabs group=instructions %}

    - Консоль управления {#console}

      * Проверьте поток данных:

          1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором вы создаете инфраструктуру.
          1. Перейдите в сервис **Data Streams**.
          1. Выберите поток данных `postbox-events-stream`.
          1. Перейдите на вкладку ![text-align-justify](../../_assets/console-icons/text-align-justify.svg) **Просмотр данных**.
          
              На графиках должны отобразиться события отправки писем.

      * Проверьте БД:

          1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором вы создаете инфраструктуру.
          1. Перейдите в сервис **Managed Service for&nbsp;YDB**.
          1. Выберите базу данных `postbox-events-ydb`.
          1. Перейдите на вкладку ![image](../../_assets/console-icons/folder.svg) **Навигация**
          1. Выберите таблицу `postbox_events`.

              В таблице должны появиться записи. В некоторых столбцах может быть значение `NULL` — это зависит от [типа уведомления](../../postbox/concepts/notification.md#types), которое было получено от сервиса Yandex Cloud Postbox.

    {% endlist %}


## Настройте визуализацию в DataLens {#datalens}

Чтобы наблюдать за отправкой писем, настройте [подключение](../../datalens/concepts/connection/index.md), создайте [датасет](../../datalens/dataset/index.md), [чарты](../../datalens/concepts/chart/index.md) и [дашборд](../../datalens/concepts/dashboard.md).


### Создайте подключение {#connection}

{% list tabs group=instructions %}

- Интерфейс DataLens {#console}

  1. Перейдите на [главную страницу](https://datalens.ru/?skipPromo=true) DataLens.
  1. На панели слева выберите ![thunderbolt](../../_assets/console-icons/thunderbolt.svg) **Подключения** и нажмите кнопку **Создать подключение**.
  1. Выберите коннектор **YDB**.
  1. Укажите параметры подключения:

      * **Облако и каталог** — выберите каталог, в котором выполняете руководство.
      * **Сервисный аккаунт** — `yds-functions`.
      * **База данных** — `postbox-events-ydb`.
      * **Время жизни кеша в секундах** — `По умолчанию`.
      * Включите опцию **Уровень доступа SQL-запросов** и выберите `Только подзапросы`.

  1. Нажмите кнопку **Создать подключение**.
  1. В открывшемся окне выберите воркбук, в котором будет создано подключение, и нажмите кнопку **Создать**.
  1. Введите имя подключения `postbox-events-connection` и нажмите **Создать**.

{% endlist %}


### Создайте датасет {#dataset}

{% list tabs group=instructions %}

- Интерфейс DataLens {#console}

  1. Перейдите на [главную страницу](https://datalens.ru/promo) DataLens.
  1. Нажмите **Начать в облаке**.
  1. На панели слева выберите ![circles-intersection](../../_assets/console-icons/circles-intersection.svg) **Датасеты** и нажмите кнопку **Создать датасет**.
  1. В открывшемся окне выберите воркбук, в котором вы создали подключение, и нажмите кнопку **Создать**.
  1. В блоке **Подключения** нажмите ![plus](../../_assets/console-icons/plus.svg) **Добавить** и выберите созданное ранее подключение `postbox-events-connection`.
  1. В блоке **Таблицы** выберите таблицу `postbox-events` и перетащите ее вправо.
  1. Нажмите кнопку **Сохранить**.
  1. В открывшемся окне укажите имя датасета `postbox-events-dataset` и нажмите **Создать**.

{% endlist %}


### Создайте чарты {#charts}

В качестве примера приведено создание чартов [Количество событий по дням](#events-by-days) и [Список событий](#events-list). Аналогичным способом вы можете создать и другие чарты.


#### Количество событий по дням {#events-by-days}

{% list tabs group=instructions %}

- Интерфейс DataLens {#console}

  1. Перейдите на [главную страницу](https://datalens.ru/?skipPromo=true) DataLens.
  1. На панели слева выберите ![chart-column](../../_assets/console-icons/chart-column.svg) **Чарты**, нажмите кнопку **Создать чарт** и выберите **Чарт в Wizard**.
  1. В открывшемся окне выберите воркбук, в котором вы создали подключение, и нажмите кнопку **Создать**.
  1. В секции слева нажмите ![circles-intersection](../../_assets/console-icons/circles-intersection.svg) **Выберите датасет** и выберите `postbox-events-dataset`.
  1. Выберите [тип чарта](../../datalens/visualization-ref/line-chart.md) **Столбчатая диаграмма**.
  1. Перетащите измерения:

      * `delivery_timestamp` в секцию **X** — по оси X будут расположены даты;
      * `eventid` в секцию **Y** — значение по оси Y будет соответствовать количеству событий;
      * `eventtype` в секцию **Цвета** — типы событий будут выделены на диаграмме разными цветами.

  1. Нажмите кнопку **Сохранить**.
  1. В открывшемся окне укажите имя чарта `Количество событий по дням` и нажмите **Сохранить**.

{% endlist %}


#### Список событий {#events-list}

{% list tabs group=instructions %}

- Интерфейс DataLens {#console}

  1. Перейдите на [главную страницу](https://datalens.ru/?skipPromo=true) DataLens.
  1. На панели слева выберите ![chart-column](../../_assets/console-icons/chart-column.svg) **Чарты**, нажмите кнопку **Создать чарт** и выберите **Чарт в Wizard**.
  1. В открывшемся окне выберите воркбук, в котором вы создали подключение, и нажмите кнопку **Создать**.
  1. В секции слева нажмите ![image](../../_assets/console-icons/circles-intersection.svg) **Выберите датасет** и выберите `postbox-events-dataset`.
  1. Выберите [тип чарта](../../datalens/visualization-ref/line-chart.md) **Таблица**.
  1. Перетащите следующие измерения в секцию **Столбцы**:

      * `saved_datetime` — дата и время сохранения события;
      * `eventid` — тип события;
      * `mail_ch_to` — адрес получателя;
      * `delivery_timestamp` — дата и время доставки письма;
      * `delivery_time_ms` — время доставки в миллисекундах;
      * `mail_ch_subject` — тема письма;
      * `bounce_bounceType` — тип ошибки доставки;
      * `bounce_bounceSubType` — сообщение недоставки.

  1. Перетащите измерение `delivery_timestamp` в секцию **Сортировка**, чтобы отсортировать таблицу по времени доставки.
  1. Нажмите кнопку **Сохранить**.
  1. В открывшемся окне укажите имя чарта `Список событий` и нажмите **Сохранить**.

{% endlist %}


### Создайте дашборд {#dashboard}

{% list tabs group=instructions %}

- Интерфейс DataLens {#console}

  1. Перейдите на [главную страницу](https://datalens.ru/?skipPromo=true) DataLens.
  1. На панели слева выберите ![layout-cells-large](../../_assets/console-icons/layout-cells-large.svg) **Дашборды** и нажмите кнопку **Создать дашборд**.
  1. В открывшемся окне выберите воркбук, в котором вы создали подключение, и нажмите кнопку **Создать**.
  1. Добавьте на дашборд чарты `Количество событий по дням`, `Список событий` и другие, которые вы создали ранее:

      1. На нижней панели нажмите **Чарт**.
      1. В открывшемся окне нажмите кнопку **Выбрать** и выберите чарт `Количество событий по дням`.
      1. Нажмите кнопку **Добавить**.
      1. Повторите действия, чтобы добавить на дашборд чарт `Список событий` и (при необходимости) другие чарты.

  1. С помощью мыши измените размер и положение чартов.
  1. Нажмите кнопку **Сохранить**.
  1. В открывшемся окне введите название дашборда `postbox-events-dashboard`.
  1. Нажмите кнопку **Создать**.

{% endlist %}

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


## Как удалить созданные ресурсы {#clear-out}

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

1. [Удалите](../../functions/operations/trigger/trigger-delete.md) триггер для вызова функции Cloud Functions.
1. [Удалите](../../functions/operations/function/function-delete.md) функцию Cloud Functions.
1. [Удалите](../../ydb/operations/manage-databases.md#delete-db) базу данных Managed Service for YDB.
1. [Удалите](../../data-streams/operations/manage-streams.md#delete-data-stream) поток данных Data Streams.
1. [Удалите](../../postbox/operations/index.md) адрес и конфигурацию Yandex Cloud Postbox.
1. При необходимости [удалите](../../iam/operations/sa/delete.md) созданные сервисные аккаунты.
1. При необходимости удалите [ресурсную запись](../../dns/operations/resource-record-delete.md) и [публичную зону DNS](../../dns/operations/zone-delete.md).