---
title: 'Логи в S3'
sidebar_label: 'Логи'
description: 'Как создать выгрузку логов и скачать ее'
sidebar_position: 5
---

import Formbricks from '@theme/MDXComponents/Formbricks'
import {CustomTable} from '@selectel/docux/components'
import MoreVerticalIcon from '@selectel/docux/icons/more-vertical'

# Логи в S3

В [логах](#fields) содержится информация про запросы к бакетам.

Вы можете [выгрузить логи](#unload-logs) через панель управления.
Работать с логами также можно через [Object Storage API](/api/object-storage/).

Выгруженные логи сохраняются в выбранный бакет.
Хранение логов тарифицируется так же, как хранение других объектов в хранилище, подробнее в инструкции [Модель оплаты и цены S3](/s3/about/payment.mdx#storage-volume).

## Поля логов \{#fields}

<CustomTable>
  <table data-sticky>
    <tbody>
      <tr>
        <th>client\_ip</th>
        <td>IP-адрес, с которого пришел запрос</td>
      </tr>

      <tr>
        <th>client\_to\_server\_bytes</th>
        <td>Количество байт, переданных при запросе к хранилищу</td>
      </tr>

      <tr>
        <th>bucket\_name</th>
        <td>Имя бакета, к которому был сделан запрос</td>
      </tr>

      <tr>
        <th>host</th>
        <td>Заголовок Host — адрес, по которому был сделан запрос</td>
      </tr>

      <tr>
        <th>http\_method</th>
        <td>HTTP-метод запроса к хранилищу</td>
      </tr>

      <tr>
        <th>path</th>
        <td>Путь к бакету или объекту в хранилище, к которому был сделан запрос</td>
      </tr>

      <tr>
        <th>query</th>
        <td>Параметры запроса</td>
      </tr>

      <tr>
        <th>server\_to\_client\_bytes</th>
        <td>Количество байт, переданных в ответ на запрос</td>
      </tr>

      <tr>
        <th>status</th>
        <td>Код состояния HTTP в ответ на запрос</td>
      </tr>

      <tr>
        <th>timestamp</th>
        <td>Дата и время записи в логи</td>
      </tr>
    </tbody>
  </table>
</CustomTable>

## Выгрузить логи \{#unload-logs}

1. [Создайте выгрузку логов](#create-unloading).
2. [Скачайте выгрузку логов](#download-unloading).

### 1. Создать выгрузку логов \{#create-unloading}

1. В [панели управления](https://my.selectel.ru/storage/) в верхнем меню нажмите **Продукты** и выберите **S3**.
2. Перейдите в раздел **Логи**.
3. Выберите [регион и пул](/infrastructure/locations.mdx).
4. Нажмите **Создать выгрузку**.
5. Укажите период, за который нужно выгрузить логи.
6. Опционально: выберите [поля](#fields), которые будут отображены в логах.
   Если не выбрать, в выгрузке будут отображены все поля.
7. Опционально: выберите бакеты, логи по которым будут включены в выгрузку.
   Если не выбрать бакеты, в выгрузке будут логи по всем бакетам.
8. Опционально: укажите срок хранения логов или оставьте бессрочное хранение.
   По истечении срока хранения файл с логами будет удален из бакета.
9. Выберите бакет, в котором будет сохранен файл с логами.
   Если в хранилище нет бакетов, нажмите **Создать бакет** и [создайте новый бакет](/s3/buckets/create-bucket.mdx).
10. Нажмите **Создать выгрузку**.
    Выгрузка появится на странице **Журнал выгрузки логов** со статусом `IN PROGRESS`.
    Когда выгрузка перейдет в статус `DONE`, вы сможете [скачать ее](#download-unloading).

### 2. Скачать выгрузку логов \{#download-unloading}

Вы можете скачать выгрузку логов, срок хранения которой не истек.

:::info

Если срок истек, выгрузка будет отображаться на странице **Журнал выгрузки логов**, но файл с логами будет удален и скачивание будет недоступно.
Вы можете [пересоздать выгрузку](#recreate-unloading) с такими же параметрами.

:::

1. В [панели управления](https://my.selectel.ru/storage/) в верхнем меню нажмите **Продукты** и выберите **S3**.
2. Перейдите в раздел **Логи**.
3. В меню <MoreVerticalIcon /> выгрузки выберите **Скачать выгрузку**.

## Пересоздать выгрузку логов \{#recreate-unloading}

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

1. В [панели управления](https://my.selectel.ru/storage/) в верхнем меню нажмите **Продукты** и выберите **S3**.
2. Перейдите в раздел **Логи**.
3. В меню <MoreVerticalIcon /> выгрузки выберите **Пересоздать выгрузку**.
   Новая выгрузка добавится отдельной строкой на странице **Журнал выгрузки логов** со статусом `IN PROGRESS`.
   Когда выгрузка перейдет в статус `DONE`, вы сможете [скачать ее](#download-unloading).

<Formbricks />
