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

# Google Workspace Audit Logs source plugin

export const entity_0 = "Google Workspace Audit Logs source plugin"

export const plugin_0 = "Google Workspace Audit Logs source plugin"

The Google Workspace Audit Logs [source plugin](/ingest/pipeline/plugins/source-plugins)
(name: `gsuite-reporter`) lets you retrieve data from Google Workspace and
ingest it into a telemetry pipeline.

This is a [pull-based](/ingest/pipeline/plugins/source-plugins#push-based-and-pull-based-source-plugins) source plugin.

<Note>
  This plugin doesn't support the use of a
  [descriptive metadata name](/ingest/pipeline/plugins#descriptive-names) in the
  Pipeline Builder interface.
</Note>

<Note>
  This plugin doesn't support duplicates of itself within the same pipeline.
</Note>

## Supported telemetry types

The {plugin_0} for Chronosphere Telemetry Pipeline supports these telemetry types:

|                    Logs                    |             Metrics             |              Traces             |
| :----------------------------------------: | :-----------------------------: | :-----------------------------: |
| <Icon icon="circle-check" color="green" /> | <Icon icon="ban" color="red" /> | <Icon icon="ban" color="red" /> |

## Configuration parameters

Use the parameters in this section to configure the {entity_0}. The
Telemetry Pipeline web interface uses the items in the **Name** column to
describe these parameters. [Pipeline configuration files](/ingest/pipeline/v2/configure/config-files)
use the items in the **Key** column as YAML keys.

### API Key

| Name        | Key            | Description                                                     | Default |
| ----------- | -------------- | --------------------------------------------------------------- | ------- |
| **API Key** | `access_token` | Either an API key or a service account file for authentication. | *none*  |

### Options

| Name                    | Key                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Default                         |
| ----------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| **Enable Telemetry**    | `telemetry`        | If `true`, enables telemetry through the Google API. Accepted values: `true`, `false`.                                                                                                                                                                                                                                                                                                                                                                          | `false`                         |
| **Pull Interval**       | `pull_interval`    | The time between calls to the Google API. Minimum of `1s`.                                                                                                                                                                                                                                                                                                                                                                                                      | `30s`                           |
| **Data Directory**      | `data_dir`         | The storage path to allow resuming data collection.                                                                                                                                                                                                                                                                                                                                                                                                             | `/data/storage/gsuite-reporter` |
| **Application Name**    | `application_name` | The application name you want to get reports from. See [ApplicationName](https://developers.google.com/admin-sdk/reports/reference/rest/v1/activities/list#ApplicationName).                                                                                                                                                                                                                                                                                    | `admin`                         |
| **User Key**            | `user_key`         | The user you want to get reports from.                                                                                                                                                                                                                                                                                                                                                                                                                          | `all`                           |
| **Memory Buffer Limit** | `mem_buf_limit`    | For pipelines with the Deployment or DaemonSet [workload](/ingest/pipeline/v2/configure/kubernetes/workloads) type only. Sets a limit for how much buffered data the plugin can write to memory, which affects [backpressure](/ingest/pipeline/v2/configure/backpressure). This value must follow Fluent Bit's rules for [unit sizes](https://docs.fluentbit.io/manual/administration/configuring-fluent-bit#unit-sizes). If unspecified, no limit is enforced. | *none*                          |