## Index

- `https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.Logs` (interface)
- `https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.ListLabelValuesRequest` (message)
- `https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.ListLabelValuesResponse` (message)
- `https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.ListLabelsRequest` (message)
- `https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.ListLabelsResponse` (message)
- `https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.ListLogsFilter` (message)
- `https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.ListLogsRequest` (message)
- `https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.ListLogsResponse` (message)
- `https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.Log` (message)

## Logs

Provides operations for logs in the time series database.

| ListLabelValues |
|---|
| `` rpc ListLabelValues(`https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.ListLabelValuesRequest`) returns (`https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.ListLabelValuesResponse`) `` Lists all label values in the time series database that match the request conditions. |

| ListLabels |
|---|
| `` rpc ListLabels(`https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.ListLabelsRequest`) returns (`https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.ListLabelsResponse`) `` Lists all the labels for log streams in the time series database that match the request conditions. |

| ListLogs |
|---|
| `` rpc ListLogs(`https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.ListLogsRequest`) returns (`https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.ListLogsResponse`) `` Lists all logs across all times series that match the request conditions. |

## ListLabelValuesRequest

Request message to list all values of a given label.

| Fields ||
|---|---|
| `parent` | `string` Required. The name of the project from which labels are listed. |
| `label` | `string` Required. The name of the label from which values are listed. |
| `page_size` | `int32` The maximum number of values to return. The service might return fewer values than what this field specifies. If unspecified, at most 100 logs are returned. The maximum value is `1000`. Values above `1000` are limited to `1000`. |
| `page_token` | `string` A page token, received from a previous `ListLabelValues` call. Provide this value to retrieve the subsequent page. When paginating, all other parameters provided to `ListLabelValues` must match the call that provided the page token. |
| `start_time` | `` `https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` `` The earliest timestamp from which to list labels. |
| `end_time` | `` `https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` `` The latest timestamp from which to list labels. |

## ListLabelValuesResponse

Response message to list all values of a given label.

| Fields ||
|---|---|
| `values[]` | `string` A list of all values for the given label. |
| `next_page_token` | `string` A page token, received from a previous `ListLogs` call. Provide this value to retrieve the subsequent page. When paginating, all other parameters provided to `ListLogs` must match the call that provided the page token. |

## ListLabelsRequest

Request message to get a list of log stream labels.

| Fields ||
|---|---|
| `parent` | `string` Required. The project from which to list labels from. |
| `page_size` | `int32` The maximum number of values to return. The service might return fewer than what this field specifies. If unspecified, at most 100 labels are returned. The maximum value is `1000`. Values above `1000` are limited to `1000`. |
| `page_token` | `string` A page token, received from a previous `ListLabels` call. Provide this value to retrieve the subsequent page. When paginating, all other parameters provided to `ListLabels` must match the call that provided the page token. |
| `start_time` | `` `https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` `` The earliest timestamp from which to list log stream labels. |
| `end_time` | `` `https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` `` The latest timestamp from which to list log stream labels. |

## ListLabelsResponse

Response message for getting list of log stream labels.

| Fields ||
|---|---|
| `labels[]` | `string` The labels found in the time series database. |
| `next_page_token` | `string` A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, then no subsequent pages exist. |

## ListLogsFilter

Message representing the filtering conditions on which log streams must be returned from the `ListLogs` request.

| Fields ||
|---|---|
| `labels_equal` | `map<string, string>` The values to which each log stream returned must have the labels set. |
| `labels_not_equal` | `map<string, string>` The values to which each log stream returned must not have the labels set. |
| `labels_match_regex` | `map<string, string>` The regular expression to which each log stream returned must have the labels matched. |
| `order_ascending` | `bool` An indicator determining whether logs must be returned in ascending (oldest first) order. |
| `start_time` | `` `https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` `` The earliest timestamp from which to start collecting logs. |
| `end_time` | `` `https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` `` The latest timestamp from which to start collecting logs. |

## ListLogsRequest

Request message to list logs in a given log stream.

| Fields ||
|---|---|
| `parent` | `string` Required. The project from which to list logs. |
| `logs_filter` | `` `https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.ListLogsFilter` `` Filter to limit the scope of the logs based on Loki labels and times. |
| `page_size` | `int32` The maximum number of values to return. The service might return fewer values than what this field specifies. If unspecified, at most 100 logs are returned. The maximum value is `1000`. Values above `1000` are limited to `1000`. |
| `page_token` | `string` A page token, received from a previous `ListLogs` call. Provide this value to retrieve the subsequent page. When paginating, all other parameters provided to `ListLogs` must match the call that provided the page token. |

## ListLogsResponse

Response method from the `ListLogs` function returning logs that match the request conditions.

| Fields ||
|---|---|
| `logs[]` | `` `https://docs.cloud.google.com/distributed-cloud/hosted/docs/1.16/gdcag/apis/service/logging/v1/goog.gdc.logging.v1#goog.gdc.logging.v1.Log` `` The logs found in the time series database. |
| `next_page_token` | `string` A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, then no subsequent pages exist. |

## Log

Message representing one log message.

| Fields ||
|---|---|
| `produced_time` | `` `https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` `` The time at which this log was produced. |
| `labels` | `map<string, string>` The labels associated with the time series this log came from. |
| `log` | `string` The log message, which is a key-value map. |