Prerequisites
- Web console
- CLI
- Go SDK
- Python SDK
- JavaScript SDK
- Make sure you are in a group that has the
adminorauditlogs.audit-event-viewerrole within your tenant. You can check this in the Administration → IAM section of the web console. - Identify the regions to search for the audit events you need.
- Install and configure the Nebius AI Cloud CLI.
- Make sure you are in a group that has the
adminorauditlogs.audit-event-viewerrole within your tenant. You can check this in the Administration → IAM section of the web console. - Identify the regions to search for the audit events you need.
- Install and initialize the Nebius SDK for Go.
- Make sure you are in a group that has the
adminorauditlogs.audit-event-viewerrole within your tenant. You can check this in the Administration → IAM section of the web console. - Identify the regions to search for the audit events you need.
- Install and initialize the Nebius SDK for Python.
- Make sure you are in a group that has the
adminorauditlogs.audit-event-viewerrole within your tenant. You can check this in the Administration → IAM section of the web console. - Identify the regions to search for the audit events you need.
- Install and initialize the Nebius SDK for JavaScript.
- Make sure you are in a group that has the
adminorauditlogs.audit-event-viewerrole within your tenant. You can check this in the Administration → IAM section of the web console. - Identify the regions to search for the audit events you need.
How to view events
- Web console
- CLI
- Go SDK
- Python SDK
- JavaScript SDK
In the sidebar, go to
Administration → Audit Logs. To work with the events on this page, you can do the following:
-
On the Logs tab:
- Select the event type: Control plane or Data plane. Control plane events track management operations on resources (such as creating or deleting virtual machines). Data plane events track data access operations (such as reading or writing objects in Object Storage).
- Select the region.
- View event JSONs. To do this, click
in an event’s row.
- Filter events by period or by using filters. Click
Filters and select the filters you need.
-
On the Metrics tab:
- Select the event type: Control plane or Data plane.
- Select the region.
- View the number of events processed per second in a specific region and time period.
- Only for data plane events, view information related to quota usage. For more information, see Quotas in Audit Logs.
-
Get all events in the tenant:
In the command above, specify:
nebius audit v2 audit-event list \ --parent-id <tenant_ID> \ --start <time_in_ISO_8601> \ --end <time_in_ISO_8601> \ --region <region_ID>--parent-id: Tenant ID.--start: Start time for the search, in the ISO 8601 format.--end: End time for the search, in the ISO 8601 format.--region: Region to search for audit events.
nebius audit v2 audit-event list --parent-id <tenant_ID> \ --start 2025-03-01T00:00:00Z \ --end 2025-04-01T00:00:00Z \ --region <region_ID> -
(Optional) By default, only control plane events are shown.
- Control plane events (default): Track management operations on resources, such as creating, updating, or deleting virtual machines, clusters, or other infrastructure resources.
- Data plane events: Track data access operations, such as reading or writing objects in Object Storage buckets.
data_planein the--event-typeparameter:nebius audit v2 audit-event list \ --parent-id <tenant_ID> \ --start <time_in_ISO_8601> \ --end <time_in_ISO_8601> \ --event-type data_plane \ --region <region_ID> - (Optional) To narrow down events, use filters.
-
Get all events in the tenant:
In the code, specify:
periodStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } periodEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } periodService := sdk.Services().Audit().V2().AuditEvent() periodEvents, err := periodService.List( ctx, &audit.ListAuditEventRequest{ ParentId: "<tenant_ID>", Start: timestamppb.New(periodStart), End: timestamppb.New(periodEnd), Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("list audit events: %w", err) } fmt.Println(periodEvents)ParentId: Tenant ID.Start: Start time for the search, in the ISO 8601 format with a timezone, for example,2026-05-07T10:00:00Z.End: End time for the search, in the ISO 8601 format with a timezone.Region: Region to search for audit events.
In this example,marchStart, err := time.Parse( time.RFC3339, "2025-03-01T00:00:00Z", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } marchEnd, err := time.Parse( time.RFC3339, "2025-04-01T00:00:00Z", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } marchService := sdk.Services().Audit().V2().AuditEvent() marchEvents, err := marchService.List( ctx, &audit.ListAuditEventRequest{ ParentId: "<tenant_ID>", Start: timestamppb.New(marchStart), End: timestamppb.New(marchEnd), Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("list audit events: %w", err) } fmt.Println(marchEvents)Startis2025-03-01T00:00:00ZandEndis2025-04-01T00:00:00Z. SetParentIdto the tenant ID andRegionto the region. -
(Optional) By default, only control plane events are shown.
- Control plane events (default): Track management operations on resources, such as creating, updating or deleting virtual machines, clusters or other infrastructure resources.
- Data plane events: Track data access operations, such as reading or writing objects in Object Storage buckets.
EventTypetoaudit.EventType_DATA_PLANE:In the code, specify:dataPlaneStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } dataPlaneEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } dataPlaneService := sdk.Services().Audit().V2().AuditEvent() dataPlaneEvents, err := dataPlaneService.List( ctx, &audit.ListAuditEventRequest{ ParentId: "<tenant_ID>", Start: timestamppb.New(dataPlaneStart), End: timestamppb.New(dataPlaneEnd), EventType: audit.EventType_DATA_PLANE, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("list audit events: %w", err) } fmt.Println(dataPlaneEvents) - (Optional) To narrow down events, use filters.
-
Get all events in the tenant:
In the code, specify:
event_service = AuditEventServiceClient(sdk) events = await event_service.list( ListAuditEventRequest( parent_id="<tenant_ID>", start=datetime.fromisoformat("<time_in_ISO_8601>"), end=datetime.fromisoformat("<time_in_ISO_8601>"), region="<region_ID>", ), ) print(events)parent_id: Tenant ID.start: Start time for the search, in the ISO 8601 format with a timezone, for example,2026-05-07T00:00:00Z. On Python 3.10, use+00:00instead ofZ.end: End time for the search, in the ISO 8601 format with a timezone, for example,2026-05-08T00:00:00Z. On Python 3.10, use+00:00instead ofZ.region: Region to search for audit events.
In this example,event_service = AuditEventServiceClient(sdk) events = await event_service.list( ListAuditEventRequest( parent_id="<tenant_ID>", start=datetime.fromisoformat("2025-03-01T00:00:00Z"), end=datetime.fromisoformat("2025-04-01T00:00:00Z"), region="<region_ID>", ), ) print(events)startis2025-03-01T00:00:00Zandendis2025-04-01T00:00:00Z. On Python 3.10, use+00:00instead ofZ. Setparent_idto the tenant ID andregionto the region. -
(Optional) By default, only control plane events are shown.
- Control plane events (default): Track management operations on resources, such as creating, updating or deleting virtual machines, clusters or other infrastructure resources.
- Data plane events: Track data access operations, such as reading or writing objects in Object Storage buckets.
event_typetoEventType.DATA_PLANE:In the code, specify:event_service = AuditEventServiceClient(sdk) events = await event_service.list( ListAuditEventRequest( parent_id="<tenant_ID>", start=datetime.fromisoformat("<time_in_ISO_8601>"), end=datetime.fromisoformat("<time_in_ISO_8601>"), event_type=EventType.DATA_PLANE, region="<region_ID>", ), ) print(events)parent_id: Tenant ID.start: Start time for the search, in the ISO 8601 format with a timezone, for example,2026-05-07T00:00:00Z. On Python 3.10, use+00:00instead ofZ.end: End time for the search, in the ISO 8601 format with a timezone, for example,2026-05-08T00:00:00Z. On Python 3.10, use+00:00instead ofZ.event_type:EventType.DATA_PLANE.region: Region to search for audit events.
- (Optional) To narrow down events, use filters.
-
Get all events in the tenant:
In the code, specify:
const periodService = new AuditEventService(sdk); const periodEvents = await periodService.list( ListAuditEventRequest.create({ parentId: "<tenant_ID>", start: dayjs("<time_in_ISO_8601>"), end: dayjs("<time_in_ISO_8601>"), region: "<region_ID>", }), ).result; console.log(periodEvents);parentId: Tenant ID.start: Start time for the search, in the ISO 8601 format.end: End time for the search, in the ISO 8601 format.region: Region to search for audit events.
In this example,const marchService = new AuditEventService(sdk); const marchEvents = await marchService.list( ListAuditEventRequest.create({ parentId: "<tenant_ID>", start: dayjs("2025-03-01T00:00:00Z"), end: dayjs("2025-04-01T00:00:00Z"), region: "<region_ID>", }), ).result; console.log(marchEvents);startis2025-03-01T00:00:00Zandendis2025-04-01T00:00:00Z. SetparentIdto the tenant ID andregionto the region. -
(Optional) By default, only control plane events are shown.
- Control plane events (default): Track management operations on resources, such as creating, updating or deleting virtual machines, clusters or other infrastructure resources.
- Data plane events: Track data access operations, such as reading or writing objects in Object Storage buckets.
eventTypetoEventType.DATA_PLANE:In the code, specify:const dataPlaneService = new AuditEventService(sdk); const dataPlaneEvents = await dataPlaneService.list( ListAuditEventRequest.create({ parentId: "<tenant_ID>", start: dayjs("<time_in_ISO_8601>"), end: dayjs("<time_in_ISO_8601>"), eventType: EventType.DATA_PLANE, region: "<region_ID>", }), ).result; console.log(dataPlaneEvents); - (Optional) To narrow down events, use filters.