---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
  - property: og:type
    content: article
  - property: article:section
    content: Интеграция с другими сервисами
  - property: og:title
    content: Аудит-логи
  - property: article:tag
    content: Техническая инструкция
alternate:
  - https://yandex.ru/support/tracker/en/manager/audit-log.md
  - https://yandex.ru/support/tracker/ru/manager/audit-log.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/ru/llms.txt


# Аудит-логи

Аудит-логи позволяют отслеживать основные события и активность сотрудников вашей организации. Это может быть полезно при инцидентах и нарушении безопасности.

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

## Как подключить {#enable}

Возможность использовать аудит-логи зависит от тарифа вашей организации Яндекс 360. Тарифы и их возможности описаны в [Справке Яндекс 360 для бизнеса](https://yandex.ru/support/yandex-360/business/purchase/ru/plans).

Чтобы использовать аудит-логи, администратору нужно подключить эту функцию в кабинете организации. [Как подключить аудит-логи](https://yandex.ru/support/yandex-360/business/admin/ru/admin-audit-log.html)

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

## Как посмотреть логи {#view}

Для просмотра аудит-логов используйте API Яндекс 360. В кабинете организации просмотреть аудит-логи Трекера невозможно.

Для работы с API вам потребуются:

* [OAuth-токен](*token) с правами доступа к аудит-логам: `ya360_security:read_auditlog`. Чтобы получить токен, воспользуйтесь инструкцией на странице [Доступ к API](https://yandex.ru/support/tracker/ru/api-ref/access.md).

* Идентификатор организации: откройте [кабинет организации](https://admin.yandex.ru) и выберите **Общие настройки** → **Профиль организации**. Идентификатор будет написан под названием организации.

Чтобы получить логи, сформируйте запрос:

```bash
curl -X GET -H "Authorization: OAuth {oauth_token}" https://cloud-api.yandex.net/v1/auditlog/organizations/{org_id}/events?ended_at={ended_at}&count={count}
```

В код подставьте обязательные параметры:

- `{org_id}` — идентификатор организации.
- `{oauth_token}` — OAuth-токен.
- `{ended_at}` — дата и время окончания аудит-лога в формате ISO 8601, например `2024-01-31T23:59:59`.
- `{count}` — количество событий на одной странице результатов от 1 до 100.

Чтобы уточнить запрос, укажите в конце запроса дополнительные параметры через символ `&`:
- `{types}` — типы событий, которые должны быть включены в список.  Можно указать несколько типов через запятую без пробела.
- `{started_at}` — дата и время начала аудит-лога в формате ISO 8601, например 2024-01-01T00:00:00.
- `{include_uids}` — список пользователей, действия которых должны быть включены в список событий. Можно указать нескольких пользователей через запятую без пробела, например: `include_uids=1,2,3`.

Полное описание всех методов для получения аудит-логов вы найдете в [документации API Яндекс 360](https://yandex.ru/dev/api360/doc/ru/audit-logs/get-logs).

## Типы событий {#events}

Список событий Трекера, которые фиксируются в логах:

<!-- source: ru/_includes/tracker-audit-log-events.md -->
#|
|| **Имя события**               | **Описание** {width=350px} | **Параметры** ||
|| `tracker_entity-access-updated` | Изменение прав доступа пользователя, группы или роли к сущности Трекера.    |
{% cut "Список параметров события" %}

* `entity_type` — тип сущности. Допустимые значения:
    * `queue` — очередь,
    * `board` — доска,
    * `dashboard` — дашборд,
    * `project` — проект,
    * `portfolio` — портфель,
    * `goal` — цель,
    * `report` — отчет,
    * `component` — компонент,
* `entity_id` — внутренний идентификатор сущности,
* `entity_short_id` — короткий числовой идентификатор сущности,
* `entity_key` — ключ сущности (например, `MYQUEUE`),
* `entity_name` — название сущности,
* `source` — источник события,
* `users` — список пользователей, для которых изменились права. Каждый элемент содержит:
    * `passport_id` — идентификатор пользователя,
    * `login` — логин пользователя,
    * `display` — отображаемое имя пользователя,
    * `is_robot` — признак технического пользователя,
    * `email` — электронная почта пользователя,
    * `access.old_value` — список прав до изменения,
    * `access.new_value` — список прав после изменения,
* `groups` — список групп, для которых изменились права. Каждый элемент содержит:
    * `directory_id` — идентификатор группы в Directory,
    * `display` — отображаемое название группы,
    * `type` — тип группы,
    * `access.old_value` — список прав до изменения,
    * `access.new_value` — список прав после изменения,
* `roles` — список ролей, для которых изменились права. Каждый элемент содержит:
    * `id` — идентификатор роли,
    * `ru_display` — отображаемое название роли,
    * `access.old_value` — список прав до изменения,
    * `access.new_value` — список прав после изменения.

{% endcut %}
||
|| `tracker_issue-access-updated`  | Изменение прав доступа пользователя к задаче — например, при добавлении компонента с ограниченным доступом. |
{% cut "Список параметров события" %}

* `issue_id` — внутренний идентификатор задачи,
* `issue_key` — ключ задачи (например, `MYQUEUE-42`),
* `source` — источник события,
* `components` — компоненты, изменение которых повлекло смену прав доступа:
    * `added[]` — добавленные компоненты. Каждый элемент содержит:
        * `id` — идентификатор компонента,
        * `name` — название компонента,
    * `removed[]` — удаленные компоненты. Каждый элемент содержит:
        * `id` — идентификатор компонента,
        * `name` — название компонента,
* `fields[]` — поля задачи, изменение которых повлекло смену прав доступа. Каждый элемент содержит:
    * `id` — идентификатор поля,
    * `ru_display` — отображаемое название поля,
    * `users` — пользователи, для которых изменились права:
        * `added[]` — пользователи, получившие доступ. Каждый элемент содержит:
            * `passport_id` — идентификатор,
            * `login` — логин,
            * `display` — отображаемое имя,
            * `robot` — признак технического пользователя,
            * `email` — электронная почта,
        * `removed[]` — пользователи, потерявшие доступ (аналогичные поля).

{% endcut %}
||
|| `tracker_issue-created`        | Создание задачи.                                                             |
{% cut "Список параметров события" %}

* `issue_id` — внутренний идентификатор задачи,
* `issue_key` — ключ задачи (например, `MYQUEUE-42`),
* `source` — источник события,
* `executed_triggers[]` — триггеры, сработавшие при создании задачи. Каждый элемент содержит:
    * `short_id` — короткий идентификатор триггера,
    * `name` — название триггера,
* `applied_autoactions` — автодействие, сработавшее при создании задачи:
    * `short_id` — короткий идентификатор автодействия,
    * `name` — название автодействия.

{% endcut %}
||
|| `tracker_issue-updated`        | Изменение задачи — обновление полей, смена статуса.                          |
{% cut "Список параметров события" %}

* `issue_id` — внутренний идентификатор задачи,
* `issue_key` — ключ задачи (например, `MYQUEUE-42`),
* `source` — источник события,
* `executed_macros` — макрос, примененный при изменении задачи:
    * `short_id` — короткий идентификатор макроса,
    * `name` — название макроса,
* `executed_triggers[]` — триггеры, сработавшие при изменении задачи. Каждый элемент содержит:
    * `short_id` — короткий идентификатор триггера,
    * `name` — название триггера,
* `applied_autoactions` — автодействие, сработавшее при изменении задачи:
    * `short_id` — короткий идентификатор автодействия,
    * `name` — название автодействия,
* `changes[]` — список измененных полей задачи. Каждый элемент содержит:
    * `field_id` — идентификатор поля,
    * `field_type` — тип поля: `system` — системное, `custom` — пользовательское, `local` — локальное,
    * `ru_display` — отображаемое название поля.

{% endcut %}
||
|| `tracker_issue-cloned`         | Клонирование задачи.                                                         |
{% cut "Список параметров события" %}

* `source_issue_id` — внутренний идентификатор исходной задачи,
* `source_issue_key` — ключ исходной задачи (например, `MYQUEUE-42`),
* `new_issue_id` — внутренний идентификатор новой задачи,
* `new_issue_key` — ключ новой задачи,
* `source` — источник события,
* `executed_triggers[]` — триггеры, сработавшие при клонировании. Каждый элемент содержит:
    * `short_id` — короткий идентификатор триггера,
    * `name` — название триггера,
* `applied_autoactions` — автодействие, сработавшее при клонировании:
    * `short_id` — короткий идентификатор автодействия,
    * `name` — название автодействия.

{% endcut %}
||
|| `tracker_issue-moved`          | Перемещение задачи в другую очередь.                                         |
{% cut "Список параметров события" %}

* `issue_id` — внутренний идентификатор задачи,
* `source` — источник события,
* `old_issue_key` — старый ключ задачи до перемещения,
* `new_issue_key` — новый ключ задачи после перемещения,
* `old_queue_key` — ключ исходной очереди,
* `new_queue_key` — ключ целевой очереди.

{% endcut %}
||
|| `tracker_issue-comment-added`   | Добавление комментария к задаче.                                             |
{% cut "Список параметров события" %}

* `issue_id` — внутренний идентификатор задачи,
* `issue_key` — ключ задачи (например, `MYQUEUE-42`),
* `source` — источник события,
* `author` — автор комментария:
    * `passport_id` — идентификатор,
    * `login` — логин,
    * `display` — отображаемое имя,
    * `is_robot` — признак технического пользователя,
    * `email` — электронная почта,
* `comment` — данные комментария:
    * `id` — идентификатор комментария,
    * `reply_to` — идентификатор комментария, на который дан ответ,
    * `summon_users[]` — упомянутые пользователи. Каждый элемент содержит:
        * `passport_id` — идентификатор,
        * `login` — логин,
        * `display` — отображаемое имя,
        * `is_robot` — признак технического пользователя,
        * `email` — электронная почта.

{% endcut %}
||
|| `tracker_issue-links-changed`   | Изменение связей задачи — добавление, удаление или изменение типа связи.     |
{% cut "Список параметров события" %}

* `issue_id` — внутренний идентификатор задачи,
* `issue_key` — ключ задачи (например, `MYQUEUE-42`),
* `source` — источник события,
* `links` — изменения связей:
    * `added[]` — добавленные связи. Каждый элемент содержит:
        * `issue_id` — идентификатор связанной задачи,
        * `issue_key` — ключ связанной задачи,
        * `relationship` — тип связи,
    * `removed[]` — удаленные связи. Каждый элемент содержит:
        * `issue_id` — идентификатор связанной задачи,
        * `issue_key` — ключ связанной задачи,
        * `relationship` — тип связи,
    * `updated[]` — измененные связи. Каждый элемент содержит:
        * `issue_id` — идентификатор связанной задачи,
        * `issue_key` — ключ связанной задачи,
        * `old_relationship` — прежний тип связи,
        * `new_relationship` — новый тип связи.

{% endcut %}
||
|| `tracker_metaentity-created`   | Создание мета-сущности — проекта, портфеля, цели или отчета.                 |
{% cut "Список параметров события" %}

* `entity_type` — тип сущности. Допустимые значения:
    * `project` — проект,
    * `portfolio` — портфель,
    * `goal` — цель,
    * `report` — отчет,
* `entity_id` — внутренний идентификатор сущности,
* `entity_short_id` — короткий числовой идентификатор сущности,
* `source` — источник события.

{% endcut %}
||
|| `tracker_metaentity-updated`   | Изменение мета-сущности — проекта, портфеля, цели или отчета.                |
{% cut "Список параметров события" %}

* `entity_type` — тип сущности. Допустимые значения:
    * `project` — проект,
    * `portfolio` — портфель,
    * `goal` — цель,
    * `report` — отчет,
* `entity_id` — внутренний идентификатор сущности,
* `entity_short_id` — короткий числовой идентификатор сущности,
* `source` — источник события.

{% endcut %}
||
|| `tracker_queue-created`        | Создание очереди.                                                            |
{% cut "Список параметров события" %}

* `queue_id` — внутренний идентификатор очереди,
* `queue_short_id` — короткий числовой идентификатор очереди,
* `queue_key` — ключ очереди (например, `MYQUEUE`),
* `queue_name` — название очереди,
* `source` — источник события.

{% endcut %}
||
|| `tracker_queue-updated`        | Изменение настроек очереди — владельца, команды, наблюдателей.               |
{% cut "Список параметров события" %}

* `queue_id` — внутренний идентификатор очереди,
* `queue_short_id` — короткий числовой идентификатор очереди,
* `queue_key` — ключ очереди (например, `MYQUEUE`),
* `queue_name` — название очереди,
* `source` — источник события,
* `lead_change` — изменение владельца очереди:
    * `old_lead` — прежний владелец:
        * `passport_id` — идентификатор,
        * `login` — логин,
        * `display` — отображаемое имя,
        * `is_robot` — признак технического пользователя,
        * `email` — электронная почта,
    * `new_lead` — новый владелец (аналогичные поля),
* `team_change` — изменения в составе команды очереди:
    * `added[]` — добавленные участники (поля аналогичны `old_lead`),
    * `removed[]` — удаленные участники (поля аналогичны `old_lead`),
* `followers_change` — изменения в списке наблюдателей очереди:
    * `added[]` — добавленные наблюдатели (поля аналогичны `old_lead`),
    * `removed[]` — удаленные наблюдатели (поля аналогичны `old_lead`).

{% endcut %}
||
|| `tracker_component-created`    | Создание компонента очереди.                                                 |
{% cut "Список параметров события" %}

* `queue_id` — внутренний идентификатор очереди,
* `queue_short_id` — короткий числовой идентификатор очереди,
* `queue_key` — ключ очереди,
* `queue_name` — название очереди,
* `source` — источник события,
* `component_id` — внутренний идентификатор компонента,
* `component_short_id` — короткий числовой идентификатор компонента,
* `component_name` — название компонента.

{% endcut %}
||
|| `tracker_component-updated`    | Изменение компонента очереди.                                                |
{% cut "Список параметров события" %}

* `queue_id` — внутренний идентификатор очереди,
* `queue_short_id` — короткий числовой идентификатор очереди,
* `queue_key` — ключ очереди,
* `queue_name` — название очереди,
* `source` — источник события,
* `component_id` — внутренний идентификатор компонента,
* `component_short_id` — короткий числовой идентификатор компонента,
* `component_name` — название компонента.

{% endcut %}
||
|| `tracker_component-deleted`    | Удаление компонента очереди.                                                 |
{% cut "Список параметров события" %}

* `queue_id` — внутренний идентификатор очереди,
* `queue_short_id` — короткий числовой идентификатор очереди,
* `queue_key` — ключ очереди,
* `queue_name` — название очереди,
* `source` — источник события,
* `component_id` — внутренний идентификатор компонента,
* `component_short_id` — короткий числовой идентификатор компонента,
* `component_name` — название компонента.

{% endcut %}
||
|| `tracker_automatization-created` | Создание автоматизации в очереди — триггера, автодействия или макроса.     |
{% cut "Список параметров события" %}

* `queue_id` — внутренний идентификатор очереди,
* `queue_short_id` — короткий числовой идентификатор очереди,
* `queue_key` — ключ очереди,
* `queue_name` — название очереди,
* `source` — источник события,
* `automatization_type` — тип автоматизации: `trigger` — триггер, `autoaction` — автодействие, `macro` — макрос,
* `automatization_short_id` — короткий числовой идентификатор автоматизации,
* `automatization_name` — название автоматизации.

{% endcut %}
||
|| `tracker_automatization-updated` | Изменение автоматизации в очереди — триггера, автодействия или макроса.    |
{% cut "Список параметров события" %}

* `queue_id` — внутренний идентификатор очереди,
* `queue_short_id` — короткий числовой идентификатор очереди,
* `queue_key` — ключ очереди,
* `queue_name` — название очереди,
* `source` — источник события,
* `automatization_type` — тип автоматизации: `trigger` — триггер, `autoaction` — автодействие, `macro` — макрос,
* `automatization_short_id` — короткий числовой идентификатор автоматизации,
* `automatization_name` — название автоматизации.

{% endcut %}
||
|| `tracker_automatization-deleted` | Удаление автоматизации из очереди — триггера, автодействия или макроса.    |
{% cut "Список параметров события" %}

* `queue_id` — внутренний идентификатор очереди,
* `queue_short_id` — короткий числовой идентификатор очереди,
* `queue_key` — ключ очереди,
* `queue_name` — название очереди,
* `source` — источник события,
* `automatization_type` — тип автоматизации: `trigger` — триггер, `autoaction` — автодействие, `macro` — макрос,
* `automatization_short_id` — короткий числовой идентификатор автоматизации,
* `automatization_name` — название автоматизации.

{% endcut %}
||
|| `tracker_board-created`        | Создание доски.                                                              |
{% cut "Список параметров события" %}

* `board_short_id` — внутренний идентификатор доски,
* `board_key` — ключ доски,
* `board_name` — название доски,
* `source` — источник события.

{% endcut %}
||
|| `tracker_board-updated`        | Изменение доски — например, смена владельца.                                 |
{% cut "Список параметров события" %}

* `board_short_id` — внутренний идентификатор доски,
* `board_key` — ключ доски,
* `board_name` — название доски,
* `source` — источник события,
* `owner_change` — изменение владельца доски:
    * `old_owner` — прежний владелец:
        * `passport_id` — идентификатор,
        * `login` — логин,
        * `display` — отображаемое имя,
        * `is_robot` — признак технического пользователя,
        * `email` — электронная почта,
    * `new_owner` — новый владелец (аналогичные поля).

{% endcut %}
||
|| `tracker_board-deleted`        | Удаление доски.                                                              |
{% cut "Список параметров события" %}

* `board_short_id` — внутренний идентификатор доски,
* `board_key` — ключ доски,
* `board_name` — название доски,
* `source` — источник события.

{% endcut %}
||
|| `tracker_dashboard-created`    | Создание дашборда.                                                           |
{% cut "Список параметров события" %}

* `dashboard_short_id` — внутренний идентификатор дашборда,
* `dashboard_name` — название дашборда,
* `source` — источник события,
* `owner` — владелец дашборда:
    * `passport_id` — идентификатор,
    * `login` — логин,
    * `display` — отображаемое имя,
    * `is_robot` — признак технического пользователя,
    * `email` — электронная почта.

{% endcut %}
||
|| `tracker_dashboard-updated`    | Изменение дашборда.                                                          |
{% cut "Список параметров события" %}

* `dashboard_short_id` — внутренний идентификатор дашборда,
* `dashboard_name` — название дашборда,
* `source` — источник события,
* `owner_change` — изменение владельца дашборда:
    * `old_owner` — прежний владелец:
        * `passport_id` — идентификатор,
        * `login` — логин,
        * `display` — отображаемое имя,
        * `is_robot` — признак технического пользователя,
        * `email` — электронная почта,
    * `new_owner` — новый владелец (аналогичные поля).

{% endcut %}
||
|| `tracker_dashboard-deleted`    | Удаление дашборда.                                                           |
{% cut "Список параметров события" %}

* `dashboard_short_id` — внутренний идентификатор дашборда,
* `dashboard_name` — название дашборда,
* `source` — источник события.

{% endcut %}
||
|| `tracker_dashboard-widget-created`       | Создание виджета на дашборде.                                                |
{% cut "Список параметров события" %}

* `dashboard_short_id` — внутренний идентификатор дашборда, которому принадлежит виджет,
* `widget_short_id` — внутренний идентификатор виджета,
* `widget_type` — тип виджета,
* `source` — источник события,
* `widget_description` — описание виджета.

{% endcut %}
||
|| `tracker_dashboard-widget-updated`       | Изменение виджета на дашборде.                                               |
{% cut "Список параметров события" %}

* `dashboard_short_id` — внутренний идентификатор дашборда, которому принадлежит виджет,
* `widget_short_id` — внутренний идентификатор виджета,
* `widget_type` — тип виджета,
* `source` — источник события,
* `widget_description` — описание виджета.

{% endcut %}
||
|| `tracker_dashboard-widget-deleted`       | Удаление виджета с дашборда.                                                 |
{% cut "Список параметров события" %}

* `dashboard_short_id` — внутренний идентификатор дашборда, которому принадлежит виджет,
* `widget_short_id` — внутренний идентификатор виджета,
* `widget_type` — тип виджета,
* `source` — источник события,
* `widget_description` — описание виджета.

{% endcut %}
||
|#
<!-- endsource: ru/_includes/tracker-audit-log-events.md -->

[*token]: Токен — это секретный ключ для доступа к API. Он подтверждает пользователя или приложение, поэтому его нельзя передавать другим.