# LoggingConfig

Specifies the logging behavior for transfer operations.

Logs can be sent to Cloud Logging for all transfer types. See [Read transfer logs](https://cloud.google.com/storage-transfer/docs/read-transfer-logs) for details.

| JSON representation |
|---|
| ``` { "logActions": [ enum (`https://docs.cloud.google.com/storage-transfer/docs/reference/rest/v1/LoggingConfig#LoggableAction`) ], "logActionStates": [ enum (`https://docs.cloud.google.com/storage-transfer/docs/reference/rest/v1/LoggingConfig#LoggableActionState`) ], "enableOnpremGcsTransferLogs": boolean } ``` |

| Fields ||
|---|---|
| `logActions[]` | ``enum (`https://docs.cloud.google.com/storage-transfer/docs/reference/rest/v1/LoggingConfig#LoggableAction`)`` Specifies the actions to be logged. If empty, no logs are generated. |
| `logActionStates[]` | ``enum (`https://docs.cloud.google.com/storage-transfer/docs/reference/rest/v1/LoggingConfig#LoggableActionState`)`` States in which `logActions` are logged. If empty, no logs are generated. |
| `enableOnpremGcsTransferLogs` | `boolean` For PosixFilesystem transfers, enables [file system transfer logs](https://cloud.google.com/storage-transfer/docs/on-prem-transfer-log-format) instead of, or in addition to, Cloud Logging. This option ignores \[LoggableAction\] and \[LoggableActionState\]. If these are set, Cloud Logging will also be enabled for this transfer. |

## LoggableAction

Loggable actions.

| Enums ||
|---|---|
| `LOGGABLE_ACTION_UNSPECIFIED` | Default value. This value is unused. |
| `FIND` | Listing objects in a bucket. |
| `DELETE` | Deleting objects at the source or the destination. |
| `COPY` | Copying objects to the destination. |

## LoggableActionState

Loggable action states.

| Enums ||
|---|---|
| `LOGGABLE_ACTION_STATE_UNSPECIFIED` | Default value. This value is unused. |
| `SUCCEEDED` | `LoggableAction` completed successfully. `SUCCEEDED` actions are logged as `INFO`. |
| `FAILED` | `LoggableAction` terminated in an error state. `FAILED` actions are logged as `ERROR`. |
| `SKIPPED` | The `COPY` action was skipped for this file. Only supported for agent-based transfers. `SKIPPED` actions are logged as `INFO`. |