...
ActiveGo 1.8Package logging
Overview ▹
Index ▹
Variables
var LogMetric_ApiVersion_name = map[int32]string{
0: "V2",
1: "V1",
}
var LogMetric_ApiVersion_value = map[string]int32{
"V2": 0,
"V1": 1,
}
var LogSink_VersionFormat_name = map[int32]string{
0: "VERSION_FORMAT_UNSPECIFIED",
1: "V2",
2: "V1",
}
var LogSink_VersionFormat_value = map[string]int32{
"VERSION_FORMAT_UNSPECIFIED": 0,
"V2": 1,
"V1": 2,
}
func RegisterConfigServiceV2Server ¶
func RegisterConfigServiceV2Server(s *grpc.Server, srv ConfigServiceV2Server)
func RegisterLoggingServiceV2Server ¶
func RegisterLoggingServiceV2Server(s *grpc.Server, srv LoggingServiceV2Server)
func RegisterMetricsServiceV2Server ¶
func RegisterMetricsServiceV2Server(s *grpc.Server, srv MetricsServiceV2Server)
type ConfigServiceV2Client ¶
type ConfigServiceV2Client interface {
// Lists sinks.
ListSinks(ctx context.Context, in *ListSinksRequest, opts ...grpc.CallOption) (*ListSinksResponse, error)
// Gets a sink.
GetSink(ctx context.Context, in *GetSinkRequest, opts ...grpc.CallOption) (*LogSink, error)
// Creates a sink that exports specified log entries to a destination. The
// export of newly-ingested log entries begins immediately, unless the current
// time is outside the sink's start and end times or the sink's
// `writer_identity` is not permitted to write to the destination. A sink can
// export log entries only from the resource owning the sink.
CreateSink(ctx context.Context, in *CreateSinkRequest, opts ...grpc.CallOption) (*LogSink, error)
// Updates a sink. If the named sink doesn't exist, then this method is
// identical to
// [sinks.create](/logging/docs/api/reference/rest/v2/projects.sinks/create).
// If the named sink does exist, then this method replaces the following
// fields in the existing sink with values from the new sink: `destination`,
// `filter`, `output_version_format`, `start_time`, and `end_time`.
// The updated filter might also have a new `writer_identity`; see the
// `unique_writer_identity` field.
UpdateSink(ctx context.Context, in *UpdateSinkRequest, opts ...grpc.CallOption) (*LogSink, error)
// Deletes a sink. If the sink has a unique `writer_identity`, then that
// service account is also deleted.
DeleteSink(ctx context.Context, in *DeleteSinkRequest, opts ...grpc.CallOption) (*google_protobuf5.Empty, error)
}
func NewConfigServiceV2Client ¶
func NewConfigServiceV2Client(cc *grpc.ClientConn) ConfigServiceV2Client
type ConfigServiceV2Server ¶
type ConfigServiceV2Server interface {
// Lists sinks.
ListSinks(context.Context, *ListSinksRequest) (*ListSinksResponse, error)
// Gets a sink.
GetSink(context.Context, *GetSinkRequest) (*LogSink, error)
// Creates a sink that exports specified log entries to a destination. The
// export of newly-ingested log entries begins immediately, unless the current
// time is outside the sink's start and end times or the sink's
// `writer_identity` is not permitted to write to the destination. A sink can
// export log entries only from the resource owning the sink.
CreateSink(context.Context, *CreateSinkRequest) (*LogSink, error)
// Updates a sink. If the named sink doesn't exist, then this method is
// identical to
// [sinks.create](/logging/docs/api/reference/rest/v2/projects.sinks/create).
// If the named sink does exist, then this method replaces the following
// fields in the existing sink with values from the new sink: `destination`,
// `filter`, `output_version_format`, `start_time`, and `end_time`.
// The updated filter might also have a new `writer_identity`; see the
// `unique_writer_identity` field.
UpdateSink(context.Context, *UpdateSinkRequest) (*LogSink, error)
// Deletes a sink. If the sink has a unique `writer_identity`, then that
// service account is also deleted.
DeleteSink(context.Context, *DeleteSinkRequest) (*google_protobuf5.Empty, error)
}
type CreateLogMetricRequest ¶
The parameters to CreateLogMetric.
type CreateLogMetricRequest struct {
// The resource name of the project in which to create the metric:
//
// "projects/[PROJECT_ID]"
//
// The new metric must be provided in the request.
Parent string `protobuf:"bytes,1,opt,name=parent" json:"parent,omitempty"`
// The new logs-based metric, which must not have an identifier that
// already exists.
Metric *LogMetric `protobuf:"bytes,2,opt,name=metric" json:"metric,omitempty"`
}
func (*CreateLogMetricRequest) Descriptor ¶
func (*CreateLogMetricRequest) Descriptor() ([]byte, []int)
func (*CreateLogMetricRequest) GetMetric ¶
func (m *CreateLogMetricRequest) GetMetric() *LogMetric
func (*CreateLogMetricRequest) GetParent ¶
func (m *CreateLogMetricRequest) GetParent() string
func (*CreateLogMetricRequest) ProtoMessage ¶
func (*CreateLogMetricRequest) ProtoMessage()
func (*CreateLogMetricRequest) Reset ¶
func (m *CreateLogMetricRequest) Reset()
func (*CreateLogMetricRequest) String ¶
func (m *CreateLogMetricRequest) String() string
type CreateSinkRequest ¶
The parameters to `CreateSink`.
type CreateSinkRequest struct {
// Required. The resource in which to create the sink:
//
// "projects/[PROJECT_ID]"
// "organizations/[ORGANIZATION_ID]"
// "billingAccounts/[BILLING_ACCOUNT_ID]"
// "folders/[FOLDER_ID]"
//
// Examples: `"projects/my-logging-project"`, `"organizations/123456789"`.
Parent string `protobuf:"bytes,1,opt,name=parent" json:"parent,omitempty"`
// Required. The new sink, whose `name` parameter is a sink identifier that
// is not already in use.
Sink *LogSink `protobuf:"bytes,2,opt,name=sink" json:"sink,omitempty"`
// Optional. Determines the kind of IAM identity returned as `writer_identity`
// in the new sink. If this value is omitted or set to false, and if the
// sink's parent is a project, then the value returned as `writer_identity` is
// the same group or service account used by Stackdriver Logging before the
// addition of writer identities to this API. The sink's destination must be
// in the same project as the sink itself.
//
// If this field is set to true, or if the sink is owned by a non-project
// resource such as an organization, then the value of `writer_identity` will
// be a unique service account used only for exports from the new sink. For
// more information, see `writer_identity` in [LogSink][google.logging.v2.LogSink].
UniqueWriterIdentity bool `protobuf:"varint,3,opt,name=unique_writer_identity,json=uniqueWriterIdentity" json:"unique_writer_identity,omitempty"`
}
func (*CreateSinkRequest) Descriptor ¶
func (*CreateSinkRequest) Descriptor() ([]byte, []int)
func (*CreateSinkRequest) GetParent ¶
func (m *CreateSinkRequest) GetParent() string
func (*CreateSinkRequest) GetSink ¶
func (m *CreateSinkRequest) GetSink() *LogSink
func (*CreateSinkRequest) GetUniqueWriterIdentity ¶
func (m *CreateSinkRequest) GetUniqueWriterIdentity() bool
func (*CreateSinkRequest) ProtoMessage ¶
func (*CreateSinkRequest) ProtoMessage()
func (*CreateSinkRequest) Reset ¶
func (m *CreateSinkRequest) Reset()
func (*CreateSinkRequest) String ¶
func (m *CreateSinkRequest) String() string
type DeleteLogMetricRequest ¶
The parameters to DeleteLogMetric.
type DeleteLogMetricRequest struct {
// The resource name of the metric to delete:
//
// "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
MetricName string `protobuf:"bytes,1,opt,name=metric_name,json=metricName" json:"metric_name,omitempty"`
}
func (*DeleteLogMetricRequest) Descriptor ¶
func (*DeleteLogMetricRequest) Descriptor() ([]byte, []int)
func (*DeleteLogMetricRequest) GetMetricName ¶
func (m *DeleteLogMetricRequest) GetMetricName() string
func (*DeleteLogMetricRequest) ProtoMessage ¶
func (*DeleteLogMetricRequest) ProtoMessage()
func (*DeleteLogMetricRequest) Reset ¶
func (m *DeleteLogMetricRequest) Reset()
func (*DeleteLogMetricRequest) String ¶
func (m *DeleteLogMetricRequest) String() string
type DeleteLogRequest ¶
The parameters to DeleteLog.
type DeleteLogRequest struct {
// Required. The resource name of the log to delete:
//
// "projects/[PROJECT_ID]/logs/[LOG_ID]"
// "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
// "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
// "folders/[FOLDER_ID]/logs/[LOG_ID]"
//
// `[LOG_ID]` must be URL-encoded. For example,
// `"projects/my-project-id/logs/syslog"`,
// `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`.
// For more information about log names, see
// [LogEntry][google.logging.v2.LogEntry].
LogName string `protobuf:"bytes,1,opt,name=log_name,json=logName" json:"log_name,omitempty"`
}
func (*DeleteLogRequest) Descriptor ¶
func (*DeleteLogRequest) Descriptor() ([]byte, []int)
func (*DeleteLogRequest) GetLogName ¶
func (m *DeleteLogRequest) GetLogName() string
func (*DeleteLogRequest) ProtoMessage ¶
func (*DeleteLogRequest) ProtoMessage()
func (*DeleteLogRequest) Reset ¶
func (m *DeleteLogRequest) Reset()
func (*DeleteLogRequest) String ¶
func (m *DeleteLogRequest) String() string
type DeleteSinkRequest ¶
The parameters to `DeleteSink`.
type DeleteSinkRequest struct {
// Required. The full resource name of the sink to delete, including the
// parent resource and the sink identifier:
//
// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
//
// Example: `"projects/my-project-id/sinks/my-sink-id"`.
SinkName string `protobuf:"bytes,1,opt,name=sink_name,json=sinkName" json:"sink_name,omitempty"`
}
func (*DeleteSinkRequest) Descriptor ¶
func (*DeleteSinkRequest) Descriptor() ([]byte, []int)
func (*DeleteSinkRequest) GetSinkName ¶
func (m *DeleteSinkRequest) GetSinkName() string
func (*DeleteSinkRequest) ProtoMessage ¶
func (*DeleteSinkRequest) ProtoMessage()
func (*DeleteSinkRequest) Reset ¶
func (m *DeleteSinkRequest) Reset()
func (*DeleteSinkRequest) String ¶
func (m *DeleteSinkRequest) String() string
type GetLogMetricRequest ¶
The parameters to GetLogMetric.
type GetLogMetricRequest struct {
// The resource name of the desired metric:
//
// "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
MetricName string `protobuf:"bytes,1,opt,name=metric_name,json=metricName" json:"metric_name,omitempty"`
}
func (*GetLogMetricRequest) Descriptor ¶
func (*GetLogMetricRequest) Descriptor() ([]byte, []int)
func (*GetLogMetricRequest) GetMetricName ¶
func (m *GetLogMetricRequest) GetMetricName() string
func (*GetLogMetricRequest) ProtoMessage ¶
func (*GetLogMetricRequest) ProtoMessage()
func (*GetLogMetricRequest) Reset ¶
func (m *GetLogMetricRequest) Reset()
func (*GetLogMetricRequest) String ¶
func (m *GetLogMetricRequest) String() string
type GetSinkRequest ¶
The parameters to `GetSink`.
type GetSinkRequest struct {
// Required. The resource name of the sink:
//
// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
//
// Example: `"projects/my-project-id/sinks/my-sink-id"`.
SinkName string `protobuf:"bytes,1,opt,name=sink_name,json=sinkName" json:"sink_name,omitempty"`
}
func (*GetSinkRequest) Descriptor ¶
func (*GetSinkRequest) Descriptor() ([]byte, []int)
func (*GetSinkRequest) GetSinkName ¶
func (m *GetSinkRequest) GetSinkName() string
func (*GetSinkRequest) ProtoMessage ¶
func (*GetSinkRequest) ProtoMessage()
func (*GetSinkRequest) Reset ¶
func (m *GetSinkRequest) Reset()
func (*GetSinkRequest) String ¶
func (m *GetSinkRequest) String() string
type ListLogEntriesRequest ¶
The parameters to `ListLogEntries`.
type ListLogEntriesRequest struct {
// Deprecated. Use `resource_names` instead. One or more project identifiers
// or project numbers from which to retrieve log entries. Example:
// `"my-project-1A"`. If present, these project identifiers are converted to
// resource name format and added to the list of resources in
// `resource_names`.
ProjectIds []string `protobuf:"bytes,1,rep,name=project_ids,json=projectIds" json:"project_ids,omitempty"`
// Required. Names of one or more parent resources from which to
// retrieve log entries:
//
// "projects/[PROJECT_ID]"
// "organizations/[ORGANIZATION_ID]"
// "billingAccounts/[BILLING_ACCOUNT_ID]"
// "folders/[FOLDER_ID]"
//
// Projects listed in the `project_ids` field are added to this list.
ResourceNames []string `protobuf:"bytes,8,rep,name=resource_names,json=resourceNames" json:"resource_names,omitempty"`
// Optional. A filter that chooses which log entries to return. See [Advanced
// Logs Filters](/logging/docs/view/advanced_filters). Only log entries that
// match the filter are returned. An empty filter matches all log entries in
// the resources listed in `resource_names`. Referencing a parent resource
// that is not listed in `resource_names` will cause the filter to return no
// results.
// The maximum length of the filter is 20000 characters.
Filter string `protobuf:"bytes,2,opt,name=filter" json:"filter,omitempty"`
// Optional. How the results should be sorted. Presently, the only permitted
// values are `"timestamp asc"` (default) and `"timestamp desc"`. The first
// option returns entries in order of increasing values of
// `LogEntry.timestamp` (oldest first), and the second option returns entries
// in order of decreasing timestamps (newest first). Entries with equal
// timestamps are returned in order of their `insert_id` values.
OrderBy string `protobuf:"bytes,3,opt,name=order_by,json=orderBy" json:"order_by,omitempty"`
// Optional. The maximum number of results to return from this request.
// Non-positive values are ignored. The presence of `next_page_token` in the
// response indicates that more results might be available.
PageSize int32 `protobuf:"varint,4,opt,name=page_size,json=pageSize" json:"page_size,omitempty"`
// Optional. If present, then retrieve the next batch of results from the
// preceding call to this method. `page_token` must be the value of
// `next_page_token` from the previous response. The values of other method
// parameters should be identical to those in the previous call.
PageToken string `protobuf:"bytes,5,opt,name=page_token,json=pageToken" json:"page_token,omitempty"`
}
func (*ListLogEntriesRequest) Descriptor ¶
func (*ListLogEntriesRequest) Descriptor() ([]byte, []int)
func (*ListLogEntriesRequest) GetFilter ¶
func (m *ListLogEntriesRequest) GetFilter() string
func (*ListLogEntriesRequest) GetOrderBy ¶
func (m *ListLogEntriesRequest) GetOrderBy() string
func (*ListLogEntriesRequest) GetPageSize ¶
func (m *ListLogEntriesRequest) GetPageSize() int32
func (*ListLogEntriesRequest) GetPageToken ¶
func (m *ListLogEntriesRequest) GetPageToken() string
func (*ListLogEntriesRequest) GetProjectIds ¶
func (m *ListLogEntriesRequest) GetProjectIds() []string
func (*ListLogEntriesRequest) GetResourceNames ¶
func (m *ListLogEntriesRequest) GetResourceNames() []string
func (*ListLogEntriesRequest) ProtoMessage ¶
func (*ListLogEntriesRequest) ProtoMessage()
func (*ListLogEntriesRequest) Reset ¶
func (m *ListLogEntriesRequest) Reset()
func (*ListLogEntriesRequest) String ¶
func (m *ListLogEntriesRequest) String() string
type ListLogEntriesResponse ¶
Result returned from `ListLogEntries`.
type ListLogEntriesResponse struct {
// A list of log entries.
Entries []*LogEntry `protobuf:"bytes,1,rep,name=entries" json:"entries,omitempty"`
// If there might be more results than those appearing in this response, then
// `nextPageToken` is included. To get the next set of results, call this
// method again using the value of `nextPageToken` as `pageToken`.
//
// If a value for `next_page_token` appears and the `entries` field is empty,
// it means that the search found no log entries so far but it did not have
// time to search all the possible log entries. Retry the method with this
// value for `page_token` to continue the search. Alternatively, consider
// speeding up the search by changing your filter to specify a single log name
// or resource type, or to narrow the time range of the search.
NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken" json:"next_page_token,omitempty"`
}
func (*ListLogEntriesResponse) Descriptor ¶
func (*ListLogEntriesResponse) Descriptor() ([]byte, []int)
func (*ListLogEntriesResponse) GetEntries ¶
func (m *ListLogEntriesResponse) GetEntries() []*LogEntry
func (*ListLogEntriesResponse) GetNextPageToken ¶
func (m *ListLogEntriesResponse) GetNextPageToken() string
func (*ListLogEntriesResponse) ProtoMessage ¶
func (*ListLogEntriesResponse) ProtoMessage()
func (*ListLogEntriesResponse) Reset ¶
func (m *ListLogEntriesResponse) Reset()
func (*ListLogEntriesResponse) String ¶
func (m *ListLogEntriesResponse) String() string
type ListLogMetricsRequest ¶
The parameters to ListLogMetrics.
type ListLogMetricsRequest struct {
// Required. The name of the project containing the metrics:
//
// "projects/[PROJECT_ID]"
Parent string `protobuf:"bytes,1,opt,name=parent" json:"parent,omitempty"`
// Optional. If present, then retrieve the next batch of results from the
// preceding call to this method. `pageToken` must be the value of
// `nextPageToken` from the previous response. The values of other method
// parameters should be identical to those in the previous call.
PageToken string `protobuf:"bytes,2,opt,name=page_token,json=pageToken" json:"page_token,omitempty"`
// Optional. The maximum number of results to return from this request.
// Non-positive values are ignored. The presence of `nextPageToken` in the
// response indicates that more results might be available.
PageSize int32 `protobuf:"varint,3,opt,name=page_size,json=pageSize" json:"page_size,omitempty"`
}
func (*ListLogMetricsRequest) Descriptor ¶
func (*ListLogMetricsRequest) Descriptor() ([]byte, []int)
func (*ListLogMetricsRequest) GetPageSize ¶
func (m *ListLogMetricsRequest) GetPageSize() int32
func (*ListLogMetricsRequest) GetPageToken ¶
func (m *ListLogMetricsRequest) GetPageToken() string
func (*ListLogMetricsRequest) GetParent ¶
func (m *ListLogMetricsRequest) GetParent() string
func (*ListLogMetricsRequest) ProtoMessage ¶
func (*ListLogMetricsRequest) ProtoMessage()
func (*ListLogMetricsRequest) Reset ¶
func (m *ListLogMetricsRequest) Reset()
func (*ListLogMetricsRequest) String ¶
func (m *ListLogMetricsRequest) String() string
type ListLogMetricsResponse ¶
Result returned from ListLogMetrics.
type ListLogMetricsResponse struct {
// A list of logs-based metrics.
Metrics []*LogMetric `protobuf:"bytes,1,rep,name=metrics" json:"metrics,omitempty"`
// If there might be more results than appear in this response, then
// `nextPageToken` is included. To get the next set of results, call this
// method again using the value of `nextPageToken` as `pageToken`.
NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken" json:"next_page_token,omitempty"`
}
func (*ListLogMetricsResponse) Descriptor ¶
func (*ListLogMetricsResponse) Descriptor() ([]byte, []int)
func (*ListLogMetricsResponse) GetMetrics ¶
func (m *ListLogMetricsResponse) GetMetrics() []*LogMetric
func (*ListLogMetricsResponse) GetNextPageToken ¶
func (m *ListLogMetricsResponse) GetNextPageToken() string
func (*ListLogMetricsResponse) ProtoMessage ¶
func (*ListLogMetricsResponse) ProtoMessage()
func (*ListLogMetricsResponse) Reset ¶
func (m *ListLogMetricsResponse) Reset()
func (*ListLogMetricsResponse) String ¶
func (m *ListLogMetricsResponse) String() string
type ListLogsRequest ¶
The parameters to ListLogs.
type ListLogsRequest struct {
// Required. The resource name that owns the logs:
//
// "projects/[PROJECT_ID]"
// "organizations/[ORGANIZATION_ID]"
// "billingAccounts/[BILLING_ACCOUNT_ID]"
// "folders/[FOLDER_ID]"
Parent string `protobuf:"bytes,1,opt,name=parent" json:"parent,omitempty"`
// Optional. The maximum number of results to return from this request.
// Non-positive values are ignored. The presence of `nextPageToken` in the
// response indicates that more results might be available.
PageSize int32 `protobuf:"varint,2,opt,name=page_size,json=pageSize" json:"page_size,omitempty"`
// Optional. If present, then retrieve the next batch of results from the
// preceding call to this method. `pageToken` must be the value of
// `nextPageToken` from the previous response. The values of other method
// parameters should be identical to those in the previous call.
PageToken string `protobuf:"bytes,3,opt,name=page_token,json=pageToken" json:"page_token,omitempty"`
}
func (*ListLogsRequest) Descriptor ¶
func (*ListLogsRequest) Descriptor() ([]byte, []int)
func (*ListLogsRequest) GetPageSize ¶
func (m *ListLogsRequest) GetPageSize() int32
func (*ListLogsRequest) GetPageToken ¶
func (m *ListLogsRequest) GetPageToken() string
func (*ListLogsRequest) GetParent ¶
func (m *ListLogsRequest) GetParent() string
func (*ListLogsRequest) ProtoMessage ¶
func (*ListLogsRequest) ProtoMessage()
func (*ListLogsRequest) Reset ¶
func (m *ListLogsRequest) Reset()
func (*ListLogsRequest) String ¶
func (m *ListLogsRequest) String() string
type ListLogsResponse ¶
Result returned from ListLogs.
type ListLogsResponse struct {
// A list of log names. For example,
// `"projects/my-project/syslog"` or
// `"organizations/123/cloudresourcemanager.googleapis.com%2Factivity"`.
LogNames []string `protobuf:"bytes,3,rep,name=log_names,json=logNames" json:"log_names,omitempty"`
// If there might be more results than those appearing in this response, then
// `nextPageToken` is included. To get the next set of results, call this
// method again using the value of `nextPageToken` as `pageToken`.
NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken" json:"next_page_token,omitempty"`
}
func (*ListLogsResponse) Descriptor ¶
func (*ListLogsResponse) Descriptor() ([]byte, []int)
func (*ListLogsResponse) GetLogNames ¶
func (m *ListLogsResponse) GetLogNames() []string
func (*ListLogsResponse) GetNextPageToken ¶
func (m *ListLogsResponse) GetNextPageToken() string
func (*ListLogsResponse) ProtoMessage ¶
func (*ListLogsResponse) ProtoMessage()
func (*ListLogsResponse) Reset ¶
func (m *ListLogsResponse) Reset()
func (*ListLogsResponse) String ¶
func (m *ListLogsResponse) String() string
type ListMonitoredResourceDescriptorsRequest ¶
The parameters to ListMonitoredResourceDescriptors
type ListMonitoredResourceDescriptorsRequest struct {
// Optional. The maximum number of results to return from this request.
// Non-positive values are ignored. The presence of `nextPageToken` in the
// response indicates that more results might be available.
PageSize int32 `protobuf:"varint,1,opt,name=page_size,json=pageSize" json:"page_size,omitempty"`
// Optional. If present, then retrieve the next batch of results from the
// preceding call to this method. `pageToken` must be the value of
// `nextPageToken` from the previous response. The values of other method
// parameters should be identical to those in the previous call.
PageToken string `protobuf:"bytes,2,opt,name=page_token,json=pageToken" json:"page_token,omitempty"`
}
func (*ListMonitoredResourceDescriptorsRequest) Descriptor ¶
func (*ListMonitoredResourceDescriptorsRequest) Descriptor() ([]byte, []int)
func (*ListMonitoredResourceDescriptorsRequest) GetPageSize ¶
func (m *ListMonitoredResourceDescriptorsRequest) GetPageSize() int32
func (*ListMonitoredResourceDescriptorsRequest) GetPageToken ¶
func (m *ListMonitoredResourceDescriptorsRequest) GetPageToken() string
func (*ListMonitoredResourceDescriptorsRequest) ProtoMessage ¶
func (*ListMonitoredResourceDescriptorsRequest) ProtoMessage()
func (*ListMonitoredResourceDescriptorsRequest) Reset ¶
func (m *ListMonitoredResourceDescriptorsRequest) Reset()
func (*ListMonitoredResourceDescriptorsRequest) String ¶
func (m *ListMonitoredResourceDescriptorsRequest) String() string
type ListMonitoredResourceDescriptorsResponse ¶
Result returned from ListMonitoredResourceDescriptors.
type ListMonitoredResourceDescriptorsResponse struct {
// A list of resource descriptors.
ResourceDescriptors []*google_api3.MonitoredResourceDescriptor `protobuf:"bytes,1,rep,name=resource_descriptors,json=resourceDescriptors" json:"resource_descriptors,omitempty"`
// If there might be more results than those appearing in this response, then
// `nextPageToken` is included. To get the next set of results, call this
// method again using the value of `nextPageToken` as `pageToken`.
NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken" json:"next_page_token,omitempty"`
}
func (*ListMonitoredResourceDescriptorsResponse) Descriptor ¶
func (*ListMonitoredResourceDescriptorsResponse) Descriptor() ([]byte, []int)
func (*ListMonitoredResourceDescriptorsResponse) GetNextPageToken ¶
func (m *ListMonitoredResourceDescriptorsResponse) GetNextPageToken() string
func (*ListMonitoredResourceDescriptorsResponse) GetResourceDescriptors ¶
func (m *ListMonitoredResourceDescriptorsResponse) GetResourceDescriptors() []*google_api3.MonitoredResourceDescriptor
func (*ListMonitoredResourceDescriptorsResponse) ProtoMessage ¶
func (*ListMonitoredResourceDescriptorsResponse) ProtoMessage()
func (*ListMonitoredResourceDescriptorsResponse) Reset ¶
func (m *ListMonitoredResourceDescriptorsResponse) Reset()
func (*ListMonitoredResourceDescriptorsResponse) String ¶
func (m *ListMonitoredResourceDescriptorsResponse) String() string
type ListSinksRequest ¶
The parameters to `ListSinks`.
type ListSinksRequest struct {
// Required. The parent resource whose sinks are to be listed:
//
// "projects/[PROJECT_ID]"
// "organizations/[ORGANIZATION_ID]"
// "billingAccounts/[BILLING_ACCOUNT_ID]"
// "folders/[FOLDER_ID]"
Parent string `protobuf:"bytes,1,opt,name=parent" json:"parent,omitempty"`
// Optional. If present, then retrieve the next batch of results from the
// preceding call to this method. `pageToken` must be the value of
// `nextPageToken` from the previous response. The values of other method
// parameters should be identical to those in the previous call.
PageToken string `protobuf:"bytes,2,opt,name=page_token,json=pageToken" json:"page_token,omitempty"`
// Optional. The maximum number of results to return from this request.
// Non-positive values are ignored. The presence of `nextPageToken` in the
// response indicates that more results might be available.
PageSize int32 `protobuf:"varint,3,opt,name=page_size,json=pageSize" json:"page_size,omitempty"`
}
func (*ListSinksRequest) Descriptor ¶
func (*ListSinksRequest) Descriptor() ([]byte, []int)
func (*ListSinksRequest) GetPageSize ¶
func (m *ListSinksRequest) GetPageSize() int32
func (*ListSinksRequest) GetPageToken ¶
func (m *ListSinksRequest) GetPageToken() string
func (*ListSinksRequest) GetParent ¶
func (m *ListSinksRequest) GetParent() string
func (*ListSinksRequest) ProtoMessage ¶
func (*ListSinksRequest) ProtoMessage()
func (*ListSinksRequest) Reset ¶
func (m *ListSinksRequest) Reset()
func (*ListSinksRequest) String ¶
func (m *ListSinksRequest) String() string
type ListSinksResponse ¶
Result returned from `ListSinks`.
type ListSinksResponse struct {
// A list of sinks.
Sinks []*LogSink `protobuf:"bytes,1,rep,name=sinks" json:"sinks,omitempty"`
// If there might be more results than appear in this response, then
// `nextPageToken` is included. To get the next set of results, call the same
// method again using the value of `nextPageToken` as `pageToken`.
NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken" json:"next_page_token,omitempty"`
}
func (*ListSinksResponse) Descriptor ¶
func (*ListSinksResponse) Descriptor() ([]byte, []int)
func (*ListSinksResponse) GetNextPageToken ¶
func (m *ListSinksResponse) GetNextPageToken() string
func (*ListSinksResponse) GetSinks ¶
func (m *ListSinksResponse) GetSinks() []*LogSink
func (*ListSinksResponse) ProtoMessage ¶
func (*ListSinksResponse) ProtoMessage()
func (*ListSinksResponse) Reset ¶
func (m *ListSinksResponse) Reset()
func (*ListSinksResponse) String ¶
func (m *ListSinksResponse) String() string
type LogEntry ¶
An individual entry in a log.
type LogEntry struct {
// Required. The resource name of the log to which this log entry belongs:
//
// "projects/[PROJECT_ID]/logs/[LOG_ID]"
// "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
// "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
// "folders/[FOLDER_ID]/logs/[LOG_ID]"
//
// `[LOG_ID]` must be URL-encoded within `log_name`. Example:
// `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`.
// `[LOG_ID]` must be less than 512 characters long and can only include the
// following characters: upper and lower case alphanumeric characters,
// forward-slash, underscore, hyphen, and period.
//
// For backward compatibility, if `log_name` begins with a forward-slash, such
// as `/projects/...`, then the log entry is ingested as usual but the
// forward-slash is removed. Listing the log entry will not show the leading
// slash and filtering for a log name with a leading slash will never return
// any results.
LogName string `protobuf:"bytes,12,opt,name=log_name,json=logName" json:"log_name,omitempty"`
// Required. The monitored resource associated with this log entry.
// Example: a log entry that reports a database error would be
// associated with the monitored resource designating the particular
// database that reported the error.
Resource *google_api3.MonitoredResource `protobuf:"bytes,8,opt,name=resource" json:"resource,omitempty"`
// Optional. The log entry payload, which can be one of multiple types.
//
// Types that are valid to be assigned to Payload:
// *LogEntry_ProtoPayload
// *LogEntry_TextPayload
// *LogEntry_JsonPayload
Payload isLogEntry_Payload `protobuf_oneof:"payload"`
// Optional. The time the event described by the log entry occurred. If
// omitted in a new log entry, Stackdriver Logging will insert the time the
// log entry is received. Stackdriver Logging might reject log entries whose
// time stamps are more than a couple of hours in the future. Log entries
// with time stamps in the past are accepted.
Timestamp *google_protobuf4.Timestamp `protobuf:"bytes,9,opt,name=timestamp" json:"timestamp,omitempty"`
// Output only. The time the log entry was received by Stackdriver Logging.
ReceiveTimestamp *google_protobuf4.Timestamp `protobuf:"bytes,24,opt,name=receive_timestamp,json=receiveTimestamp" json:"receive_timestamp,omitempty"`
// Optional. The severity of the log entry. The default value is
// `LogSeverity.DEFAULT`.
Severity google_logging_type1.LogSeverity `protobuf:"varint,10,opt,name=severity,enum=google.logging.type.LogSeverity" json:"severity,omitempty"`
// Optional. A unique identifier for the log entry. If you provide a value,
// then Stackdriver Logging considers other log entries in the same project,
// with the same `timestamp`, and with the same `insert_id` to be duplicates
// which can be removed. If omitted in new log entries, then Stackdriver
// Logging will insert its own unique identifier. The `insert_id` is used
// to order log entries that have the same `timestamp` value.
InsertId string `protobuf:"bytes,4,opt,name=insert_id,json=insertId" json:"insert_id,omitempty"`
// Optional. Information about the HTTP request associated with this
// log entry, if applicable.
HttpRequest *google_logging_type.HttpRequest `protobuf:"bytes,7,opt,name=http_request,json=httpRequest" json:"http_request,omitempty"`
// Optional. A set of user-defined (key, value) data that provides additional
// information about the log entry.
Labels map[string]string `protobuf:"bytes,11,rep,name=labels" json:"labels,omitempty" protobuf_key:"bytes,1,opt,name=key" protobuf_val:"bytes,2,opt,name=value"`
// Optional. Information about an operation associated with the log entry, if
// applicable.
Operation *LogEntryOperation `protobuf:"bytes,15,opt,name=operation" json:"operation,omitempty"`
// Optional. Resource name of the trace associated with the log entry, if any.
// If it contains a relative resource name, the name is assumed to be relative
// to `//tracing.googleapis.com`. Example:
// `projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824`
Trace string `protobuf:"bytes,22,opt,name=trace" json:"trace,omitempty"`
// Optional. Source code location information associated with the log entry,
// if any.
SourceLocation *LogEntrySourceLocation `protobuf:"bytes,23,opt,name=source_location,json=sourceLocation" json:"source_location,omitempty"`
}
func (*LogEntry) Descriptor ¶
func (*LogEntry) Descriptor() ([]byte, []int)
func (*LogEntry) GetHttpRequest ¶
func (m *LogEntry) GetHttpRequest() *google_logging_type.HttpRequest
func (*LogEntry) GetInsertId ¶
func (m *LogEntry) GetInsertId() string
func (*LogEntry) GetJsonPayload ¶
func (m *LogEntry) GetJsonPayload() *google_protobuf3.Struct
func (*LogEntry) GetLabels ¶
func (m *LogEntry) GetLabels() map[string]string
func (*LogEntry) GetLogName ¶
func (m *LogEntry) GetLogName() string
func (*LogEntry) GetOperation ¶
func (m *LogEntry) GetOperation() *LogEntryOperation
func (*LogEntry) GetPayload ¶
func (m *LogEntry) GetPayload() isLogEntry_Payload
func (*LogEntry) GetProtoPayload ¶
func (m *LogEntry) GetProtoPayload() *google_protobuf2.Any
func (*LogEntry) GetReceiveTimestamp ¶
func (m *LogEntry) GetReceiveTimestamp() *google_protobuf4.Timestamp
func (*LogEntry) GetResource ¶
func (m *LogEntry) GetResource() *google_api3.MonitoredResource
func (*LogEntry) GetSeverity ¶
func (m *LogEntry) GetSeverity() google_logging_type1.LogSeverity
func (*LogEntry) GetSourceLocation ¶
func (m *LogEntry) GetSourceLocation() *LogEntrySourceLocation
func (*LogEntry) GetTextPayload ¶
func (m *LogEntry) GetTextPayload() string
func (*LogEntry) GetTimestamp ¶
func (m *LogEntry) GetTimestamp() *google_protobuf4.Timestamp
func (*LogEntry) GetTrace ¶
func (m *LogEntry) GetTrace() string
func (*LogEntry) ProtoMessage ¶
func (*LogEntry) ProtoMessage()
func (*LogEntry) Reset ¶
func (m *LogEntry) Reset()
func (*LogEntry) String ¶
func (m *LogEntry) String() string
func (*LogEntry) XXX_OneofFuncs ¶
func (*LogEntry) XXX_OneofFuncs() (func(msg proto.Message, b *proto.Buffer) error, func(msg proto.Message, tag, wire int, b *proto.Buffer) (bool, error), func(msg proto.Message) (n int), []interface{})
XXX_OneofFuncs is for the internal use of the proto package.
type LogEntryOperation ¶
Additional information about a potentially long-running operation with which a log entry is associated.
type LogEntryOperation struct {
// Optional. An arbitrary operation identifier. Log entries with the
// same identifier are assumed to be part of the same operation.
Id string `protobuf:"bytes,1,opt,name=id" json:"id,omitempty"`
// Optional. An arbitrary producer identifier. The combination of
// `id` and `producer` must be globally unique. Examples for `producer`:
// `"MyDivision.MyBigCompany.com"`, `"github.com/MyProject/MyApplication"`.
Producer string `protobuf:"bytes,2,opt,name=producer" json:"producer,omitempty"`
// Optional. Set this to True if this is the first log entry in the operation.
First bool `protobuf:"varint,3,opt,name=first" json:"first,omitempty"`
// Optional. Set this to True if this is the last log entry in the operation.
Last bool `protobuf:"varint,4,opt,name=last" json:"last,omitempty"`
}
func (*LogEntryOperation) Descriptor ¶
func (*LogEntryOperation) Descriptor() ([]byte, []int)
func (*LogEntryOperation) GetFirst ¶
func (m *LogEntryOperation) GetFirst() bool
func (*LogEntryOperation) GetId ¶
func (m *LogEntryOperation) GetId() string
func (*LogEntryOperation) GetLast ¶
func (m *LogEntryOperation) GetLast() bool
func (*LogEntryOperation) GetProducer ¶
func (m *LogEntryOperation) GetProducer() string
func (*LogEntryOperation) ProtoMessage ¶
func (*LogEntryOperation) ProtoMessage()
func (*LogEntryOperation) Reset ¶
func (m *LogEntryOperation) Reset()
func (*LogEntryOperation) String ¶
func (m *LogEntryOperation) String() string
type LogEntrySourceLocation ¶
Additional information about the source code location that produced the log entry.
type LogEntrySourceLocation struct {
// Optional. Source file name. Depending on the runtime environment, this
// might be a simple name or a fully-qualified name.
File string `protobuf:"bytes,1,opt,name=file" json:"file,omitempty"`
// Optional. Line within the source file. 1-based; 0 indicates no line number
// available.
Line int64 `protobuf:"varint,2,opt,name=line" json:"line,omitempty"`
// Optional. Human-readable name of the function or method being invoked, with
// optional context such as the class or package name. This information may be
// used in contexts such as the logs viewer, where a file and line number are
// less meaningful. The format can vary by language. For example:
// `qual.if.ied.Class.method` (Java), `dir/package.func` (Go), `function`
// (Python).
Function string `protobuf:"bytes,3,opt,name=function" json:"function,omitempty"`
}
func (*LogEntrySourceLocation) Descriptor ¶
func (*LogEntrySourceLocation) Descriptor() ([]byte, []int)
func (*LogEntrySourceLocation) GetFile ¶
func (m *LogEntrySourceLocation) GetFile() string
func (*LogEntrySourceLocation) GetFunction ¶
func (m *LogEntrySourceLocation) GetFunction() string
func (*LogEntrySourceLocation) GetLine ¶
func (m *LogEntrySourceLocation) GetLine() int64
func (*LogEntrySourceLocation) ProtoMessage ¶
func (*LogEntrySourceLocation) ProtoMessage()
func (*LogEntrySourceLocation) Reset ¶
func (m *LogEntrySourceLocation) Reset()
func (*LogEntrySourceLocation) String ¶
func (m *LogEntrySourceLocation) String() string
type LogEntry_JsonPayload ¶
type LogEntry_JsonPayload struct {
JsonPayload *google_protobuf3.Struct `protobuf:"bytes,6,opt,name=json_payload,json=jsonPayload,oneof"`
}
type LogEntry_ProtoPayload ¶
type LogEntry_ProtoPayload struct {
ProtoPayload *google_protobuf2.Any `protobuf:"bytes,2,opt,name=proto_payload,json=protoPayload,oneof"`
}
type LogEntry_TextPayload ¶
type LogEntry_TextPayload struct {
TextPayload string `protobuf:"bytes,3,opt,name=text_payload,json=textPayload,oneof"`
}
type LogMetric ¶
Describes a logs-based metric. The value of the metric is the number of log entries that match a logs filter in a given time interval.
type LogMetric struct {
// Required. The client-assigned metric identifier.
// Examples: `"error_count"`, `"nginx/requests"`.
//
// Metric identifiers are limited to 100 characters and can include
// only the following characters: `A-Z`, `a-z`, `0-9`, and the
// special characters `_-.,+!*',()%/`. The forward-slash character
// (`/`) denotes a hierarchy of name pieces, and it cannot be the
// first character of the name.
//
// The metric identifier in this field must not be
// [URL-encoded](https://en.wikipedia.org/wiki/Percent-encoding).
// However, when the metric identifier appears as the `[METRIC_ID]`
// part of a `metric_name` API parameter, then the metric identifier
// must be URL-encoded. Example:
// `"projects/my-project/metrics/nginx%2Frequests"`.
Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
// Optional. A description of this metric, which is used in documentation.
Description string `protobuf:"bytes,2,opt,name=description" json:"description,omitempty"`
// Required. An [advanced logs filter](/logging/docs/view/advanced_filters)
// which is used to match log entries.
// Example:
//
// "resource.type=gae_app AND severity>=ERROR"
//
// The maximum length of the filter is 20000 characters.
Filter string `protobuf:"bytes,3,opt,name=filter" json:"filter,omitempty"`
// Output only. The API version that created or updated this metric.
// The version also dictates the syntax of the filter expression. When a value
// for this field is missing, the default value of V2 should be assumed.
Version LogMetric_ApiVersion `protobuf:"varint,4,opt,name=version,enum=google.logging.v2.LogMetric_ApiVersion" json:"version,omitempty"`
}
func (*LogMetric) Descriptor ¶
func (*LogMetric) Descriptor() ([]byte, []int)
func (*LogMetric) GetDescription ¶
func (m *LogMetric) GetDescription() string
func (*LogMetric) GetFilter ¶
func (m *LogMetric) GetFilter() string
func (*LogMetric) GetName ¶
func (m *LogMetric) GetName() string
func (*LogMetric) GetVersion ¶
func (m *LogMetric) GetVersion() LogMetric_ApiVersion
func (*LogMetric) ProtoMessage ¶
func (*LogMetric) ProtoMessage()
func (*LogMetric) Reset ¶
func (m *LogMetric) Reset()
func (*LogMetric) String ¶
func (m *LogMetric) String() string
type LogMetric_ApiVersion ¶
Stackdriver Logging API version.
type LogMetric_ApiVersion int32
const (
// Stackdriver Logging API v2.
LogMetric_V2 LogMetric_ApiVersion = 0
// Stackdriver Logging API v1.
LogMetric_V1 LogMetric_ApiVersion = 1
)
func (LogMetric_ApiVersion) EnumDescriptor ¶
func (LogMetric_ApiVersion) EnumDescriptor() ([]byte, []int)
func (LogMetric_ApiVersion) String ¶
func (x LogMetric_ApiVersion) String() string
type LogSink ¶
Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project, organization, billing account, or folder.
type LogSink struct {
// Required. The client-assigned sink identifier, unique within the
// project. Example: `"my-syslog-errors-to-pubsub"`. Sink identifiers are
// limited to 100 characters and can include only the following characters:
// upper and lower-case alphanumeric characters, underscores, hyphens, and
// periods.
Name string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
// Required. The export destination:
//
// "storage.googleapis.com/[GCS_BUCKET]"
// "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
// "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
//
// The sink's `writer_identity`, set when the sink is created, must
// have permission to write to the destination or else the log
// entries are not exported. For more information, see
// [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
Destination string `protobuf:"bytes,3,opt,name=destination" json:"destination,omitempty"`
// Optional.
// An [advanced logs filter](/logging/docs/view/advanced_filters). The only
// exported log entries are those that are in the resource owning the sink and
// that match the filter. The filter must use the log entry format specified
// by the `output_version_format` parameter. For example, in the v2 format:
//
// logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
Filter string `protobuf:"bytes,5,opt,name=filter" json:"filter,omitempty"`
// Optional. The log entry format to use for this sink's exported log
// entries. The v2 format is used by default.
// **The v1 format is deprecated** and should be used only as part of a
// migration effort to v2.
// See [Migration to the v2 API](/logging/docs/api/v2/migration-to-v2).
OutputVersionFormat LogSink_VersionFormat `protobuf:"varint,6,opt,name=output_version_format,json=outputVersionFormat,enum=google.logging.v2.LogSink_VersionFormat" json:"output_version_format,omitempty"`
// Output only. An IAM identity—a service account or group—under
// which Stackdriver Logging writes the exported log entries to the sink's
// destination. This field is set by
// [sinks.create](/logging/docs/api/reference/rest/v2/projects.sinks/create)
// and
// [sinks.update](/logging/docs/api/reference/rest/v2/projects.sinks/update),
// based on the setting of `unique_writer_identity` in those methods.
//
// Until you grant this identity write-access to the destination, log entry
// exports from this sink will fail. For more information,
// see [Granting access for a
// resource](/iam/docs/granting-roles-to-service-accounts#granting_access_to_a_service_account_for_a_resource).
// Consult the destination service's documentation to determine the
// appropriate IAM roles to assign to the identity.
WriterIdentity string `protobuf:"bytes,8,opt,name=writer_identity,json=writerIdentity" json:"writer_identity,omitempty"`
// Optional. This field applies only to sinks owned by organizations and
// folders. If the field is false, the default, only the logs owned by the
// sink's parent resource are available for export. If the field is true, then
// logs from all the projects, folders, and billing accounts contained in the
// sink's parent resource are also available for export. Whether a particular
// log entry from the children is exported depends on the sink's filter
// expression. For example, if this field is true, then the filter
// `resource.type=gce_instance` would export all Compute Engine VM instance
// log entries from all projects in the sink's parent. To only export entries
// from certain child projects, filter on the project part of the log name:
//
// logName:("projects/test-project1/" OR "projects/test-project2/") AND
// resource.type=gce_instance
IncludeChildren bool `protobuf:"varint,9,opt,name=include_children,json=includeChildren" json:"include_children,omitempty"`
// Optional. The time at which this sink will begin exporting log entries.
// Log entries are exported only if their timestamp is not earlier than the
// start time. The default value of this field is the time the sink is
// created or updated.
StartTime *google_protobuf4.Timestamp `protobuf:"bytes,10,opt,name=start_time,json=startTime" json:"start_time,omitempty"`
// Optional. The time at which this sink will stop exporting log entries. Log
// entries are exported only if their timestamp is earlier than the end time.
// If this field is not supplied, there is no end time. If both a start time
// and an end time are provided, then the end time must be later than the
// start time.
EndTime *google_protobuf4.Timestamp `protobuf:"bytes,11,opt,name=end_time,json=endTime" json:"end_time,omitempty"`
}
func (*LogSink) Descriptor ¶
func (*LogSink) Descriptor() ([]byte, []int)
func (*LogSink) GetDestination ¶
func (m *LogSink) GetDestination() string
func (*LogSink) GetEndTime ¶
func (m *LogSink) GetEndTime() *google_protobuf4.Timestamp
func (*LogSink) GetFilter ¶
func (m *LogSink) GetFilter() string
func (*LogSink) GetIncludeChildren ¶
func (m *LogSink) GetIncludeChildren() bool
func (*LogSink) GetName ¶
func (m *LogSink) GetName() string
func (*LogSink) GetOutputVersionFormat ¶
func (m *LogSink) GetOutputVersionFormat() LogSink_VersionFormat
func (*LogSink) GetStartTime ¶
func (m *LogSink) GetStartTime() *google_protobuf4.Timestamp
func (*LogSink) GetWriterIdentity ¶
func (m *LogSink) GetWriterIdentity() string
func (*LogSink) ProtoMessage ¶
func (*LogSink) ProtoMessage()
func (*LogSink) Reset ¶
func (m *LogSink) Reset()
func (*LogSink) String ¶
func (m *LogSink) String() string
type LogSink_VersionFormat ¶
Available log entry formats. Log entries can be written to Stackdriver Logging in either format and can be exported in either format. Version 2 is the preferred format.
type LogSink_VersionFormat int32
const (
// An unspecified format version that will default to V2.
LogSink_VERSION_FORMAT_UNSPECIFIED LogSink_VersionFormat = 0
// `LogEntry` version 2 format.
LogSink_V2 LogSink_VersionFormat = 1
// `LogEntry` version 1 format.
LogSink_V1 LogSink_VersionFormat = 2
)
func (LogSink_VersionFormat) EnumDescriptor ¶
func (LogSink_VersionFormat) EnumDescriptor() ([]byte, []int)
func (LogSink_VersionFormat) String ¶
func (x LogSink_VersionFormat) String() string
type LoggingServiceV2Client ¶
type LoggingServiceV2Client interface {
// Deletes all the log entries in a log.
// The log reappears if it receives new entries.
// Log entries written shortly before the delete operation might not be
// deleted.
DeleteLog(ctx context.Context, in *DeleteLogRequest, opts ...grpc.CallOption) (*google_protobuf5.Empty, error)
// Writes log entries to Stackdriver Logging.
WriteLogEntries(ctx context.Context, in *WriteLogEntriesRequest, opts ...grpc.CallOption) (*WriteLogEntriesResponse, error)
// Lists log entries. Use this method to retrieve log entries from
// Stackdriver Logging. For ways to export log entries, see
// [Exporting Logs](/logging/docs/export).
ListLogEntries(ctx context.Context, in *ListLogEntriesRequest, opts ...grpc.CallOption) (*ListLogEntriesResponse, error)
// Lists the descriptors for monitored resource types used by Stackdriver
// Logging.
ListMonitoredResourceDescriptors(ctx context.Context, in *ListMonitoredResourceDescriptorsRequest, opts ...grpc.CallOption) (*ListMonitoredResourceDescriptorsResponse, error)
// Lists the logs in projects, organizations, folders, or billing accounts.
// Only logs that have entries are listed.
ListLogs(ctx context.Context, in *ListLogsRequest, opts ...grpc.CallOption) (*ListLogsResponse, error)
}
func NewLoggingServiceV2Client ¶
func NewLoggingServiceV2Client(cc *grpc.ClientConn) LoggingServiceV2Client
type LoggingServiceV2Server ¶
type LoggingServiceV2Server interface {
// Deletes all the log entries in a log.
// The log reappears if it receives new entries.
// Log entries written shortly before the delete operation might not be
// deleted.
DeleteLog(context.Context, *DeleteLogRequest) (*google_protobuf5.Empty, error)
// Writes log entries to Stackdriver Logging.
WriteLogEntries(context.Context, *WriteLogEntriesRequest) (*WriteLogEntriesResponse, error)
// Lists log entries. Use this method to retrieve log entries from
// Stackdriver Logging. For ways to export log entries, see
// [Exporting Logs](/logging/docs/export).
ListLogEntries(context.Context, *ListLogEntriesRequest) (*ListLogEntriesResponse, error)
// Lists the descriptors for monitored resource types used by Stackdriver
// Logging.
ListMonitoredResourceDescriptors(context.Context, *ListMonitoredResourceDescriptorsRequest) (*ListMonitoredResourceDescriptorsResponse, error)
// Lists the logs in projects, organizations, folders, or billing accounts.
// Only logs that have entries are listed.
ListLogs(context.Context, *ListLogsRequest) (*ListLogsResponse, error)
}
type MetricsServiceV2Client ¶
type MetricsServiceV2Client interface {
// Lists logs-based metrics.
ListLogMetrics(ctx context.Context, in *ListLogMetricsRequest, opts ...grpc.CallOption) (*ListLogMetricsResponse, error)
// Gets a logs-based metric.
GetLogMetric(ctx context.Context, in *GetLogMetricRequest, opts ...grpc.CallOption) (*LogMetric, error)
// Creates a logs-based metric.
CreateLogMetric(ctx context.Context, in *CreateLogMetricRequest, opts ...grpc.CallOption) (*LogMetric, error)
// Creates or updates a logs-based metric.
UpdateLogMetric(ctx context.Context, in *UpdateLogMetricRequest, opts ...grpc.CallOption) (*LogMetric, error)
// Deletes a logs-based metric.
DeleteLogMetric(ctx context.Context, in *DeleteLogMetricRequest, opts ...grpc.CallOption) (*google_protobuf5.Empty, error)
}
func NewMetricsServiceV2Client ¶
func NewMetricsServiceV2Client(cc *grpc.ClientConn) MetricsServiceV2Client
type MetricsServiceV2Server ¶
type MetricsServiceV2Server interface {
// Lists logs-based metrics.
ListLogMetrics(context.Context, *ListLogMetricsRequest) (*ListLogMetricsResponse, error)
// Gets a logs-based metric.
GetLogMetric(context.Context, *GetLogMetricRequest) (*LogMetric, error)
// Creates a logs-based metric.
CreateLogMetric(context.Context, *CreateLogMetricRequest) (*LogMetric, error)
// Creates or updates a logs-based metric.
UpdateLogMetric(context.Context, *UpdateLogMetricRequest) (*LogMetric, error)
// Deletes a logs-based metric.
DeleteLogMetric(context.Context, *DeleteLogMetricRequest) (*google_protobuf5.Empty, error)
}
type UpdateLogMetricRequest ¶
The parameters to UpdateLogMetric.
type UpdateLogMetricRequest struct {
// The resource name of the metric to update:
//
// "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
//
// The updated metric must be provided in the request and it's
// `name` field must be the same as `[METRIC_ID]` If the metric
// does not exist in `[PROJECT_ID]`, then a new metric is created.
MetricName string `protobuf:"bytes,1,opt,name=metric_name,json=metricName" json:"metric_name,omitempty"`
// The updated metric.
Metric *LogMetric `protobuf:"bytes,2,opt,name=metric" json:"metric,omitempty"`
}
func (*UpdateLogMetricRequest) Descriptor ¶
func (*UpdateLogMetricRequest) Descriptor() ([]byte, []int)
func (*UpdateLogMetricRequest) GetMetric ¶
func (m *UpdateLogMetricRequest) GetMetric() *LogMetric
func (*UpdateLogMetricRequest) GetMetricName ¶
func (m *UpdateLogMetricRequest) GetMetricName() string
func (*UpdateLogMetricRequest) ProtoMessage ¶
func (*UpdateLogMetricRequest) ProtoMessage()
func (*UpdateLogMetricRequest) Reset ¶
func (m *UpdateLogMetricRequest) Reset()
func (*UpdateLogMetricRequest) String ¶
func (m *UpdateLogMetricRequest) String() string
type UpdateSinkRequest ¶
The parameters to `UpdateSink`.
type UpdateSinkRequest struct {
// Required. The full resource name of the sink to update, including the
// parent resource and the sink identifier:
//
// "projects/[PROJECT_ID]/sinks/[SINK_ID]"
// "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
// "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
// "folders/[FOLDER_ID]/sinks/[SINK_ID]"
//
// Example: `"projects/my-project-id/sinks/my-sink-id"`.
SinkName string `protobuf:"bytes,1,opt,name=sink_name,json=sinkName" json:"sink_name,omitempty"`
// Required. The updated sink, whose name is the same identifier that appears
// as part of `sink_name`. If `sink_name` does not exist, then
// this method creates a new sink.
Sink *LogSink `protobuf:"bytes,2,opt,name=sink" json:"sink,omitempty"`
// Optional. See
// [sinks.create](/logging/docs/api/reference/rest/v2/projects.sinks/create)
// for a description of this field. When updating a sink, the effect of this
// field on the value of `writer_identity` in the updated sink depends on both
// the old and new values of this field:
//
// + If the old and new values of this field are both false or both true,
// then there is no change to the sink's `writer_identity`.
// + If the old value is false and the new value is true, then
// `writer_identity` is changed to a unique service account.
// + It is an error if the old value is true and the new value is false.
UniqueWriterIdentity bool `protobuf:"varint,3,opt,name=unique_writer_identity,json=uniqueWriterIdentity" json:"unique_writer_identity,omitempty"`
}
func (*UpdateSinkRequest) Descriptor ¶
func (*UpdateSinkRequest) Descriptor() ([]byte, []int)
func (*UpdateSinkRequest) GetSink ¶
func (m *UpdateSinkRequest) GetSink() *LogSink
func (*UpdateSinkRequest) GetSinkName ¶
func (m *UpdateSinkRequest) GetSinkName() string
func (*UpdateSinkRequest) GetUniqueWriterIdentity ¶
func (m *UpdateSinkRequest) GetUniqueWriterIdentity() bool
func (*UpdateSinkRequest) ProtoMessage ¶
func (*UpdateSinkRequest) ProtoMessage()
func (*UpdateSinkRequest) Reset ¶
func (m *UpdateSinkRequest) Reset()
func (*UpdateSinkRequest) String ¶
func (m *UpdateSinkRequest) String() string
type WriteLogEntriesPartialErrors ¶
Error details for WriteLogEntries with partial success.
type WriteLogEntriesPartialErrors struct {
// When `WriteLogEntriesRequest.partial_success` is true, records the error
// status for entries that were not written due to a permanent error, keyed
// by the entry's zero-based index in `WriteLogEntriesRequest.entries`.
//
// Failed requests for which no entries are written will not include
// per-entry errors.
LogEntryErrors map[int32]*google_rpc.Status `protobuf:"bytes,1,rep,name=log_entry_errors,json=logEntryErrors" json:"log_entry_errors,omitempty" protobuf_key:"varint,1,opt,name=key" protobuf_val:"bytes,2,opt,name=value"`
}
func (*WriteLogEntriesPartialErrors) Descriptor ¶
func (*WriteLogEntriesPartialErrors) Descriptor() ([]byte, []int)
func (*WriteLogEntriesPartialErrors) GetLogEntryErrors ¶
func (m *WriteLogEntriesPartialErrors) GetLogEntryErrors() map[int32]*google_rpc.Status
func (*WriteLogEntriesPartialErrors) ProtoMessage ¶
func (*WriteLogEntriesPartialErrors) ProtoMessage()
func (*WriteLogEntriesPartialErrors) Reset ¶
func (m *WriteLogEntriesPartialErrors) Reset()
func (*WriteLogEntriesPartialErrors) String ¶
func (m *WriteLogEntriesPartialErrors) String() string
type WriteLogEntriesRequest ¶
The parameters to WriteLogEntries.
type WriteLogEntriesRequest struct {
// Optional. A default log resource name that is assigned to all log entries
// in `entries` that do not specify a value for `log_name`:
//
// "projects/[PROJECT_ID]/logs/[LOG_ID]"
// "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
// "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
// "folders/[FOLDER_ID]/logs/[LOG_ID]"
//
// `[LOG_ID]` must be URL-encoded. For example,
// `"projects/my-project-id/logs/syslog"` or
// `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`.
// For more information about log names, see
// [LogEntry][google.logging.v2.LogEntry].
LogName string `protobuf:"bytes,1,opt,name=log_name,json=logName" json:"log_name,omitempty"`
// Optional. A default monitored resource object that is assigned to all log
// entries in `entries` that do not specify a value for `resource`. Example:
//
// { "type": "gce_instance",
// "labels": {
// "zone": "us-central1-a", "instance_id": "00000000000000000000" }}
//
// See [LogEntry][google.logging.v2.LogEntry].
Resource *google_api3.MonitoredResource `protobuf:"bytes,2,opt,name=resource" json:"resource,omitempty"`
// Optional. Default labels that are added to the `labels` field of all log
// entries in `entries`. If a log entry already has a label with the same key
// as a label in this parameter, then the log entry's label is not changed.
// See [LogEntry][google.logging.v2.LogEntry].
Labels map[string]string `protobuf:"bytes,3,rep,name=labels" json:"labels,omitempty" protobuf_key:"bytes,1,opt,name=key" protobuf_val:"bytes,2,opt,name=value"`
// Required. The log entries to write. Values supplied for the fields
// `log_name`, `resource`, and `labels` in this `entries.write` request are
// inserted into those log entries in this list that do not provide their own
// values.
//
// Stackdriver Logging also creates and inserts values for `timestamp` and
// `insert_id` if the entries do not provide them. The created `insert_id` for
// the N'th entry in this list will be greater than earlier entries and less
// than later entries. Otherwise, the order of log entries in this list does
// not matter.
//
// To improve throughput and to avoid exceeding the
// [quota limit](/logging/quota-policy) for calls to `entries.write`,
// you should write multiple log entries at once rather than
// calling this method for each individual log entry.
Entries []*LogEntry `protobuf:"bytes,4,rep,name=entries" json:"entries,omitempty"`
// Optional. Whether valid entries should be written even if some other
// entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any
// entry is not written, then the response status is the error associated
// with one of the failed entries and the response includes error details
// keyed by the entries' zero-based index in the `entries.write` method.
PartialSuccess bool `protobuf:"varint,5,opt,name=partial_success,json=partialSuccess" json:"partial_success,omitempty"`
}
func (*WriteLogEntriesRequest) Descriptor ¶
func (*WriteLogEntriesRequest) Descriptor() ([]byte, []int)
func (*WriteLogEntriesRequest) GetEntries ¶
func (m *WriteLogEntriesRequest) GetEntries() []*LogEntry
func (*WriteLogEntriesRequest) GetLabels ¶
func (m *WriteLogEntriesRequest) GetLabels() map[string]string
func (*WriteLogEntriesRequest) GetLogName ¶
func (m *WriteLogEntriesRequest) GetLogName() string
func (*WriteLogEntriesRequest) GetPartialSuccess ¶
func (m *WriteLogEntriesRequest) GetPartialSuccess() bool
func (*WriteLogEntriesRequest) GetResource ¶
func (m *WriteLogEntriesRequest) GetResource() *google_api3.MonitoredResource
func (*WriteLogEntriesRequest) ProtoMessage ¶
func (*WriteLogEntriesRequest) ProtoMessage()
func (*WriteLogEntriesRequest) Reset ¶
func (m *WriteLogEntriesRequest) Reset()
func (*WriteLogEntriesRequest) String ¶
func (m *WriteLogEntriesRequest) String() string
type WriteLogEntriesResponse ¶
Result returned from WriteLogEntries. empty
type WriteLogEntriesResponse struct {
}
func (*WriteLogEntriesResponse) Descriptor ¶
func (*WriteLogEntriesResponse) Descriptor() ([]byte, []int)
func (*WriteLogEntriesResponse) ProtoMessage ¶
func (*WriteLogEntriesResponse) ProtoMessage()
func (*WriteLogEntriesResponse) Reset ¶
func (m *WriteLogEntriesResponse) Reset()
func (*WriteLogEntriesResponse) String ¶
func (m *WriteLogEntriesResponse) String() string