Method: forwarders.importStatsEvents

Full name: projects.locations.instances.forwarders.importStatsEvents

forwarders.importStatsEvents imports stats events from a forwarder.

HTTP request


POST https://chronicle.africa-south1.rep.googleapis.com/v1beta/{name}:importStatsEvents

Path parameters

Parameters
name

string

Required. The ID of the forwarder. Format: projects/{project}/locations/{location}/instances/{instance}/forwarders/{forwarder}

Request body

The request body contains data with the following structure:

JSON representation 
{

  // Union field source can be only one of the following:
  "inlineSource": {
    object (InlineSource)
  }
  // End of list of possible types for union field source.
}
Fields
Union field source. The source of the events to be imported. source can be only one of the following:
inlineSource

object (InlineSource)

StatsEvents to be imported are specified inline.

Response body

If successful, the response body is empty.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

  • chronicle.forwarders.importStatsEvents

For more information, see the IAM documentation.

InlineSource

An import source with the events to import included inline.

JSON representation 
{
  "events": [
    {
      object (IngestionStatsEvent)
    }
  ],
  "eventBatchId": string
}
Fields
events[]

object (IngestionStatsEvent)

Required. The events being imported.
eventBatchId

string (bytes format)

Required. Batch Id to use when ingesting StatsEvents.

A base64-encoded string.

IngestionStatsEvent

message to represent the stats related event forwarder will send.

JSON representation 
{
  "eventTime": string,

  // Union field event can be only one of the following:
  "stats": {
    object (StatsEvent)
  },
  "agentStats": {
    object (AgentStatsEvent)
  }
  // End of list of possible types for union field event.
}
Fields
eventTime

string (Timestamp format)

Required. The timestamp of the event.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Union field event. The stats event to be imported, either StatsEvent or AgentStatsEvent. event can be only one of the following:
stats

object (StatsEvent)

StatsEvent generated by the forwarder.
agentStats

object (AgentStatsEvent)

AgentStatsEvent generated by the collection agent.