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

# Exporting logs

You can export logs for the Nebius AI Cloud resources you use. Log exports are stored as [objects](/object-storage/overview#objects) in [Object Storage buckets](/object-storage/overview).

## Prerequisites

<Tabs>
  <Tab title="Web console">
    1. Make sure you are in a [group](/iam/authorization/groups/index) that has at least the `editor` role within your tenant; for example, the default `editors` group. You can check this in the [Administration → IAM](https://console.nebius.com/iam) section of the web console.
    2. Make sure that you have sufficient [logging quotas](/observability/resources/quotas-limits#logs-quotas).
  </Tab>

  <Tab title="CLI">
    1. Make sure you are in a [group](/iam/authorization/groups/index) that has at least the `editor` role within your tenant; for example, the default `editors` group. You can check this in the [Administration → IAM](https://console.nebius.com/iam) section of the web console.
    2. [Install and configure the Nebius AI Cloud CLI](/cli/quickstart).
    3. Make sure that you have sufficient [logging quotas](/observability/resources/quotas-limits#logs-quotas).
    4. Make sure that you have an [Object Storage bucket](/object-storage/buckets/manage) to store exported logs.

    <Note>
      The steps to [download](#how-to-download-exported-logs) and [delete](#how-to-delete-exported-logs) exported logs require working with objects in Object Storage. If you prefer to complete these actions using the **AWS CLI** instead of the web console, the prerequisites for [Managing objects in Object Storage buckets](/object-storage/objects/manage#prerequisites) apply.
    </Note>
  </Tab>
</Tabs>

## How to export logs

<Tabs>
  <Tab title="Web console">
    1. In the [web console](https://console.nebius.com), do one of the following:
       * Go to <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/observability.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=911a6fc7da512bdf286067c68245a501" width="16" height="16" data-path="_assets/sidebar/observability.svg" /> **Observability** → **Logs** to view the logs for all Nebius AI Cloud resources you use.
       * Go to the page of the Nebius AI Cloud resource you would like to export the logs for and switch to the **Logs** tab.
    2. Use the period filter to find the logs to export.
    3. (Optional) Depending on the resource you are viewing the logs for, you can apply additional filters. From the <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/observability.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=911a6fc7da512bdf286067c68245a501" width="16" height="16" data-path="_assets/sidebar/observability.svg" /> **Observability** → **Logs** page, you can filter by resource or log level.
       You can also use the [LogQL query language](/observability/logs/query-language) to filter logs.
    4. Click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/arrow-up-to-line.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=5ed27f4ff211ee66d1ee185f2af2955e" width="16" height="16" data-path="_assets/arrow-up-to-line.svg" /> **Export logs**.
    5. In the window that opens:
       * Select a time range.
       * Select an existing bucket or create a new one to store the logs. To create a new one, see [Bucket parameters](/object-storage/buckets/manage#bucket-parameters).
       * Select a format:
         * **.json.gzip**: JSON lines (one JSON object per line) compressed with Gzip.
         * **.parquet**: [Apache Parquet](https://parquet.apache.org/docs/).
    6. Click **Export**.
  </Tab>

  <Tab title="CLI">
    Run the following command:

    ```bash theme={null}
    nebius logging export create \
      --parent-id <project_ID> \
      --bucket-name <bucket_name> \
      --filter '<LogQL_match_expression>' \
      --from <time_in_ISO_8601> \
      --to <time_in_ISO_8601> \
      --log-format <output_format> \
      
    ```

    In the command, specify the following parameters:

    * `--parent-id`: [Project ID](/iam/manage-projects#how-to-get-a-project-id).

    * `--bucket-name`: The name of the bucket to store the exported logs. Alternatively, use `--bucket-id` to specify the destination bucket by its ID. You can get the ID by running the following command if you know the bucket name:

      ```bash theme={null}
      nebius storage bucket get-by-name --name <bucket_name>
      ```

    * `--filter`: [LogQL](/observability/logs/query-language) match expression to filter logs in the project specified in `--parent-id`. Wrap the expression in single quotation marks.

    * `--from`: Start date and time for the export, in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format (for example, `2026-04-01T20:00:00Z`).

    * `--to`: End date and time for the export, in the ISO 8601 format.

    * `--log-format`: Output format. Supported values:
      * `json-gzip`: JSON lines (one JSON object per line) compressed with Gzip.
      * `parquet`: [Apache Parquet](https://parquet.apache.org/docs/).

    * `--object-prefix` (optional): Object prefix under which exported objects are written in the bucket. Defaults to `logs/`.

    * `--bucket-parent-id` (optional): To export logs to a bucket that is in a different project than the one you specified in `--parent-id`, specify the Project ID of the project that the destination bucket belongs to.

    The output looks like the following:

    ```yaml theme={null}
    id: oplogexport-e00***
    description: Export logs
    created_at: "2026-04-23T08:53:18.032304664Z"
    created_by: tenantuseraccount-e00***
    finished_at: "2026-04-23T08:53:29.261207865Z"
    request:
      params:
        log:
          filter:
            from: "2025-12-01T00:00:00Z"
            to: "2026-04-23T23:59:59Z"
            match_expression: '{__bucket__="default"}'
          format: PARQUET
        nebius_object_storage:
          by_name:
            name: my-bucket
      parent_id: project-e00***
    resource_id: project-e00***
    status: {}
    ```

    Save the operation ID from the output `id` parameter.
  </Tab>
</Tabs>

<Note>
  If the [Object Storage quota](/object-storage/resources/quotas-limits) is exceeded, the export fails due to timeout.
</Note>

## How to inspect log exports

<Tabs>
  <Tab title="Web console">
    To view all of your log exports and open the destination bucket for an export:

    1. In the [web console](https://console.nebius.com), go to <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/observability.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=911a6fc7da512bdf286067c68245a501" width="16" height="16" data-path="_assets/sidebar/observability.svg" /> **Observability** → **Logs** → **Exports**. This tab shows the following information for each export:
       * **Operation ID**: The unique identifier for the export operation. Use this ID to distinguish between exports stored in the same bucket.
       * **Status**: `In progress`, `Finished` or `Canceled`.

    2. Click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad" width="12" height="24" data-path="_assets/button-vellipsis.svg" /> → **View bucket** next to an export. The exported logs are stored in the selected bucket with the following path structure:

       ```text theme={null}
       logs/<operation_ID>/<timestamp>/<segment_number>.<extension>
       ```

       Large exports may be split into segments and stored separately. The objects are numbered sequentially starting from `0`. In some cases, segments may be split further into parts, indicated by a dash (`-`) and the part number after the segment number.

           <Accordion title="Example path">
             ```text theme={null}
             logs/oplogexport-***/2026-01-15-10:30:00/1-2.parquet
             ```
           </Accordion>
  </Tab>

  <Tab title="CLI">
    * To list the details and status of all export operations in a project, run:

      ```bash theme={null}
      nebius logging export list --parent-id <project_ID>
      ```

      In `--parent-id`, specify the [Project ID](/iam/manage-projects#how-to-get-a-project-id) that you exported logs from.

    * To check the details and status of a specific export operation, run:

      ```bash theme={null}
      nebius logging export get --id <operation_ID>
      ```

      In `--id`, specify the operation ID of the export.

      If the export is completed successfully, the `status` field in the output is empty (`status: {}`). If the export wasn't successful, the `status` field contains a `code` and a `message` that explains the issue.
  </Tab>
</Tabs>

## How to cancel an export

You can cancel an export while its status is `In progress`. If an export has the status `Finished`, you can [delete the exported logs](#how-to-delete-exported-logs) instead.

<Tabs>
  <Tab title="Web console">
    To cancel an export:

    1. On the **Logs** page, switch to the **Exports** tab.
    2. Next to the export that you want to cancel, click **Cancel**.
    3. In the window that opens, confirm the cancellation.
  </Tab>

  <Tab title="CLI">
    To cancel an export, run:

    ```bash theme={null}
    nebius logging export cancel --id <operation_ID>
    ```

    In `--id`, specify the operation ID of the export.
  </Tab>
</Tabs>

## How to download exported logs

<Note>
  Exported logs are stored as [objects](/object-storage/overview#objects) in Object Storage buckets. The Nebius AI Cloud CLI does not support downloading objects. Use the web console or, alternatively, [download the log export objects with the AWS CLI](/object-storage/objects/upload-download#how-to-download).
</Note>

1. In the [web console](https://console.nebius.com), go to <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/observability.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=911a6fc7da512bdf286067c68245a501" width="16" height="16" data-path="_assets/sidebar/observability.svg" /> **Observability** → **Logs** → **Exports**.
2. Click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad" width="12" height="24" data-path="_assets/button-vellipsis.svg" /> → **View bucket** next to the export.
3. In the bucket, open the folder where the logs are stored.
4. Navigate to the file that contains the exported logs.
5. Click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad" width="12" height="24" data-path="_assets/button-vellipsis.svg" /> → **Download**.

## How to delete exported logs

<Note>
  Exported logs are stored as [objects](/object-storage/overview#objects) in Object Storage buckets. The Nebius AI Cloud CLI does not support deleting objects. Use the web console or, alternatively, [delete the log export objects with the AWS CLI](/object-storage/objects/manage#how-to-delete-objects).
</Note>

1. In the [web console](https://console.nebius.com), go to <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/observability.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=911a6fc7da512bdf286067c68245a501" width="16" height="16" data-path="_assets/sidebar/observability.svg" /> **Observability** → **Logs** → **Exports**.
2. Click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad" width="12" height="24" data-path="_assets/button-vellipsis.svg" /> → **View bucket** next to the export.
3. In the bucket, open the folder where the logs are stored.
4. Navigate to the file that contains the exported logs.
5. Click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad" width="12" height="24" data-path="_assets/button-vellipsis.svg" /> → **Delete**.