2017-07-23 09:51:42 +02:00
// Package cloudtrace provides access to the Stackdriver Trace API.
2017-05-11 16:39:54 +02:00
//
// See https://cloud.google.com/trace
//
// Usage example:
//
2017-07-23 09:51:42 +02:00
// import "google.golang.org/api/cloudtrace/v2"
2017-05-11 16:39:54 +02:00
// ...
2017-07-23 09:51:42 +02:00
// cloudtraceService, err := cloudtrace.New(oauthHttpClient)
package cloudtrace // import "google.golang.org/api/cloudtrace/v2"
2017-05-11 16:39:54 +02:00
import (
"bytes"
"encoding/json"
"errors"
"fmt"
context "golang.org/x/net/context"
ctxhttp "golang.org/x/net/context/ctxhttp"
gensupport "google.golang.org/api/gensupport"
googleapi "google.golang.org/api/googleapi"
"io"
"net/http"
"net/url"
"strconv"
"strings"
)
// Always reference these packages, just in case the auto-generated code
// below doesn't.
var _ = bytes . NewBuffer
var _ = strconv . Itoa
var _ = fmt . Sprintf
var _ = json . NewDecoder
var _ = io . Copy
var _ = url . Parse
var _ = gensupport . MarshalJSON
var _ = googleapi . Version
var _ = errors . New
var _ = strings . Replace
var _ = context . Canceled
var _ = ctxhttp . Do
2017-07-23 09:51:42 +02:00
const apiId = "cloudtrace:v2"
const apiName = "cloudtrace"
const apiVersion = "v2"
const basePath = "https://cloudtrace.googleapis.com/"
2017-05-11 16:39:54 +02:00
// OAuth2 scopes used by this API.
const (
// View and manage your data across Google Cloud Platform services
CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform"
// Write Trace data for a project or application
TraceAppendScope = "https://www.googleapis.com/auth/trace.append"
// Read Trace data for a project or application
TraceReadonlyScope = "https://www.googleapis.com/auth/trace.readonly"
)
func New ( client * http . Client ) ( * Service , error ) {
if client == nil {
return nil , errors . New ( "client is nil" )
}
s := & Service { client : client , BasePath : basePath }
s . Projects = NewProjectsService ( s )
return s , nil
}
type Service struct {
client * http . Client
BasePath string // API endpoint base URL
UserAgent string // optional additional User-Agent fragment
Projects * ProjectsService
}
func ( s * Service ) userAgent ( ) string {
if s . UserAgent == "" {
return googleapi . UserAgent
}
return googleapi . UserAgent + " " + s . UserAgent
}
func NewProjectsService ( s * Service ) * ProjectsService {
rs := & ProjectsService { s : s }
rs . Traces = NewProjectsTracesService ( s )
return rs
}
type ProjectsService struct {
s * Service
Traces * ProjectsTracesService
}
func NewProjectsTracesService ( s * Service ) * ProjectsTracesService {
rs := & ProjectsTracesService { s : s }
2017-07-23 09:51:42 +02:00
rs . Spans = NewProjectsTracesSpansService ( s )
2017-05-11 16:39:54 +02:00
return rs
}
type ProjectsTracesService struct {
s * Service
2017-07-23 09:51:42 +02:00
Spans * ProjectsTracesSpansService
}
func NewProjectsTracesSpansService ( s * Service ) * ProjectsTracesSpansService {
rs := & ProjectsTracesSpansService { s : s }
return rs
}
type ProjectsTracesSpansService struct {
s * Service
2017-05-11 16:39:54 +02:00
}
// Annotation: Text annotation with a set of attributes.
type Annotation struct {
2017-07-23 09:51:42 +02:00
// Attributes: A set of attributes on the annotation. There is a limit
// of 4 attributes
// per Annotation.
Attributes * Attributes ` json:"attributes,omitempty" `
2017-05-11 16:39:54 +02:00
2017-07-23 09:51:42 +02:00
// Description: A user-supplied message describing the event. The
// maximum length for
// the description is 256 bytes.
Description * TruncatableString ` json:"description,omitempty" `
2017-05-11 16:39:54 +02:00
// ForceSendFields is a list of field names (e.g. "Attributes") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "Attributes") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * Annotation ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod Annotation
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
2017-07-23 09:51:42 +02:00
// AttributeValue: The allowed types for [VALUE] in a `[KEY]:[VALUE]`
// attribute.
2017-05-11 16:39:54 +02:00
type AttributeValue struct {
2017-07-23 09:51:42 +02:00
// BoolValue: A Boolean value represented by `true` or `false`.
2017-05-11 16:39:54 +02:00
BoolValue bool ` json:"boolValue,omitempty" `
2017-07-23 09:51:42 +02:00
// IntValue: A 64-bit signed integer.
2017-05-11 16:39:54 +02:00
IntValue int64 ` json:"intValue,omitempty,string" `
2017-07-23 09:51:42 +02:00
// StringValue: A string up to 256 bytes long.
StringValue * TruncatableString ` json:"stringValue,omitempty" `
2017-05-11 16:39:54 +02:00
// ForceSendFields is a list of field names (e.g. "BoolValue") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "BoolValue") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * AttributeValue ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod AttributeValue
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
2017-07-23 09:51:42 +02:00
// Attributes: A set of attributes, each in the format `[KEY]:[VALUE]`.
type Attributes struct {
// AttributeMap: The set of attributes. Each attribute's key can be up
// to 128 bytes
// long. The value can be a string up to 256 bytes, an integer, or
// the
// Boolean values `true` and `false`. For example:
//
// "/instance_id": "my-instance"
// "/http/user_agent": ""
// "/http/request_bytes": 300
// "abc.com/myattribute": true
AttributeMap map [ string ] AttributeValue ` json:"attributeMap,omitempty" `
// DroppedAttributesCount: The number of attributes that were discarded.
// Attributes can be discarded
// because their keys are too long or because there are too many
// attributes.
// If this value is 0 then all attributes are valid.
DroppedAttributesCount int64 ` json:"droppedAttributesCount,omitempty" `
2017-05-11 16:39:54 +02:00
2017-07-23 09:51:42 +02:00
// ForceSendFields is a list of field names (e.g. "AttributeMap") to
2017-05-11 16:39:54 +02:00
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
2017-07-23 09:51:42 +02:00
// NullFields is a list of field names (e.g. "AttributeMap") to include
2017-05-11 16:39:54 +02:00
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
2017-07-23 09:51:42 +02:00
func ( s * Attributes ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod Attributes
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// BatchWriteSpansRequest: The request message for the `BatchWriteSpans`
// method.
type BatchWriteSpansRequest struct {
// Spans: A collection of spans.
Spans [ ] * Span ` json:"spans,omitempty" `
// ForceSendFields is a list of field names (e.g. "Spans") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "Spans") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * BatchWriteSpansRequest ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod BatchWriteSpansRequest
2017-05-11 16:39:54 +02:00
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// Empty: A generic empty message that you can re-use to avoid defining
// duplicated
// empty messages in your APIs. A typical example is to use it as the
// request
// or the response type of an API method. For instance:
//
// service Foo {
// rpc Bar(google.protobuf.Empty) returns
// (google.protobuf.Empty);
// }
//
// The JSON representation for `Empty` is empty JSON object `{}`.
type Empty struct {
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi . ServerResponse ` json:"-" `
}
2017-07-23 09:51:42 +02:00
// Link: A pointer from the current span to another span in the same
// trace or in a
// different trace. For example, this can be used in batching
// operations,
// where a single batch handler processes multiple requests from
// different
// traces or when the handler receives a request from a different
// project.
2017-05-11 16:39:54 +02:00
type Link struct {
2017-07-23 09:51:42 +02:00
// Attributes: A set of attributes on the link. There is a limit of 32
// attributes per
// link.
Attributes * Attributes ` json:"attributes,omitempty" `
// SpanId: `SPAN_ID` identifies a span within a trace.
SpanId string ` json:"spanId,omitempty" `
2017-05-11 16:39:54 +02:00
2017-07-23 09:51:42 +02:00
// TraceId: `TRACE_ID` identifies a trace within a project.
2017-05-11 16:39:54 +02:00
TraceId string ` json:"traceId,omitempty" `
// Type: The relationship of the current span relative to the linked
// span.
//
// Possible values:
// "TYPE_UNSPECIFIED" - The relationship of the two spans is unknown.
// "CHILD" - The current span is a child of the linked span.
// "PARENT" - The current span is the parent of the linked span.
Type string ` json:"type,omitempty" `
2017-07-23 09:51:42 +02:00
// ForceSendFields is a list of field names (e.g. "Attributes") to
2017-05-11 16:39:54 +02:00
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
2017-07-23 09:51:42 +02:00
// NullFields is a list of field names (e.g. "Attributes") to include in
// API requests with the JSON null value. By default, fields with empty
2017-05-11 16:39:54 +02:00
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * Link ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod Link
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
2017-07-23 09:51:42 +02:00
// Links: A collection of links, which are references from this span to
// a span
// in the same or different trace.
type Links struct {
// DroppedLinksCount: The number of dropped links after the maximum size
// was enforced. If
// this value is 0, then no links were dropped.
DroppedLinksCount int64 ` json:"droppedLinksCount,omitempty" `
// Link: A collection of links.
Link [ ] * Link ` json:"link,omitempty" `
// ForceSendFields is a list of field names (e.g. "DroppedLinksCount")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "DroppedLinksCount") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields [ ] string ` json:"-" `
}
func ( s * Links ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod Links
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
2017-05-11 16:39:54 +02:00
// ListSpansResponse: The response message for the `ListSpans` method.
type ListSpansResponse struct {
2017-07-23 09:51:42 +02:00
// NextPageToken: If defined, indicates that there might be more spans
// that match the
// request. Pass this as the value of `pageToken` in a subsequent
// request to
// retrieve additional spans.
2017-05-11 16:39:54 +02:00
NextPageToken string ` json:"nextPageToken,omitempty" `
2017-07-23 09:51:42 +02:00
// Spans: The requested spans, if there are any in the specified trace.
2017-05-11 16:39:54 +02:00
Spans [ ] * Span ` json:"spans,omitempty" `
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi . ServerResponse ` json:"-" `
// ForceSendFields is a list of field names (e.g. "NextPageToken") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "NextPageToken") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * ListSpansResponse ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod ListSpansResponse
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// ListTracesResponse: The response message for the `ListTraces` method.
type ListTracesResponse struct {
2017-07-23 09:51:42 +02:00
// NextPageToken: If there might be more results than those appearing in
// this response, then
// `next_page_token` is included. To get the next set of results, call
// this
// method again using the value of `next_page_token` as `page_token`.
2017-05-11 16:39:54 +02:00
NextPageToken string ` json:"nextPageToken,omitempty" `
// Traces: List of trace records returned.
Traces [ ] * Trace ` json:"traces,omitempty" `
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi . ServerResponse ` json:"-" `
// ForceSendFields is a list of field names (e.g. "NextPageToken") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "NextPageToken") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * ListTracesResponse ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod ListTracesResponse
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// Module: Binary module.
type Module struct {
2017-07-23 09:51:42 +02:00
// BuildId: A unique identifier for the module, usually a hash of
// its
// contents (up to 128 bytes).
BuildId * TruncatableString ` json:"buildId,omitempty" `
2017-05-11 16:39:54 +02:00
2017-07-23 09:51:42 +02:00
// Module: For example: main binary, kernel modules, and dynamic
// libraries
// such as libc.so, sharedlib.so (up to 256 bytes).
Module * TruncatableString ` json:"module,omitempty" `
2017-05-11 16:39:54 +02:00
// ForceSendFields is a list of field names (e.g. "BuildId") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "BuildId") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * Module ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod Module
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
2017-07-23 09:51:42 +02:00
// NetworkEvent: An event describing an RPC message sent or received on
// the network.
2017-05-11 16:39:54 +02:00
type NetworkEvent struct {
// MessageId: An identifier for the message, which must be unique in
// this span.
MessageId uint64 ` json:"messageId,omitempty,string" `
// MessageSize: The number of bytes sent or received.
MessageSize uint64 ` json:"messageSize,omitempty,string" `
2017-07-23 09:51:42 +02:00
// Time: For sent messages, this is the time at which the first bit was
// sent.
// For received messages, this is the time at which the last bit
// was
// received.
Time string ` json:"time,omitempty" `
2017-05-11 16:39:54 +02:00
// Type: Type of NetworkEvent. Indicates whether the RPC message was
// sent or
// received.
//
// Possible values:
// "TYPE_UNSPECIFIED" - Unknown event type.
// "SENT" - Indicates a sent RPC message.
// "RECV" - Indicates a received RPC message.
Type string ` json:"type,omitempty" `
2017-07-23 09:51:42 +02:00
// ForceSendFields is a list of field names (e.g. "MessageId") to
2017-05-11 16:39:54 +02:00
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
2017-07-23 09:51:42 +02:00
// NullFields is a list of field names (e.g. "MessageId") to include in
2017-05-11 16:39:54 +02:00
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * NetworkEvent ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod NetworkEvent
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// Span: A span represents a single operation within a trace. Spans can
2017-07-23 09:51:42 +02:00
// be
// nested to form a trace tree. Often, a trace contains a root span
// that describes the end-to-end latency, and one or more subspans
// for
// its sub-operations. A trace can also contain multiple root spans,
// or none at all. Spans do not need to be contiguous—there may
// be
// gaps or overlaps between spans in a trace.
2017-05-11 16:39:54 +02:00
type Span struct {
2017-07-23 09:51:42 +02:00
// Attributes: A set of attributes on the span. There is a limit of 32
// attributes per
// span.
Attributes * Attributes ` json:"attributes,omitempty" `
// ChildSpanCount: An optional number of child spans that were generated
// while this span
// was active. If set, allows implementation to detect missing child
// spans.
ChildSpanCount int64 ` json:"childSpanCount,omitempty" `
// DisplayName: A description of the span's operation (up to 128
// bytes).
// Stackdriver Trace displays the description in the
// {% dynamic print site_values.console_name %}.
// For example, the display name can be a qualified method name or a
// file name
// and a line number where the operation is called. A best practice is
// to use
// the same display name within an application and at the same call
// point.
// This makes it easier to correlate spans in different traces.
DisplayName * TruncatableString ` json:"displayName,omitempty" `
// EndTime: The end time of the span. On the client side, this is the
// time kept by
// the local machine where the span execution ends. On the server side,
// this
// is the time when the server application handler stops running.
EndTime string ` json:"endTime,omitempty" `
// Links: A maximum of 128 links are allowed per Span.
Links * Links ` json:"links,omitempty" `
// Name: The resource name of the span in the following format:
2017-05-11 16:39:54 +02:00
//
2017-07-23 09:51:42 +02:00
// projects/[PROJECT_ID]traces/[TRACE_ID]/spans/SPAN_ID is a unique
// identifier for a trace within a project.
// [SPAN_ID] is a unique identifier for a span within a trace,
// assigned when the span is created.
2017-05-11 16:39:54 +02:00
Name string ` json:"name,omitempty" `
2017-07-23 09:51:42 +02:00
// ParentSpanId: The [SPAN_ID] of this span's parent span. If this is a
// root span,
// then this field must be empty.
ParentSpanId string ` json:"parentSpanId,omitempty" `
// SameProcessAsParentSpan: A highly recommended but not required flag
// that identifies when a trace
// crosses a process boundary. True when the parent_span belongs to
// the
// same process as the current span.
SameProcessAsParentSpan bool ` json:"sameProcessAsParentSpan,omitempty" `
// SpanId: The [SPAN_ID] portion of the span's resource name.
SpanId string ` json:"spanId,omitempty" `
2017-05-11 16:39:54 +02:00
// StackTrace: Stack trace captured at the start of the span.
StackTrace * StackTrace ` json:"stackTrace,omitempty" `
2017-07-23 09:51:42 +02:00
// StartTime: The start time of the span. On the client side, this is
// the time kept by
// the local machine where the span execution starts. On the server
// side, this
// is the time when the server's application handler starts running.
StartTime string ` json:"startTime,omitempty" `
2017-05-11 16:39:54 +02:00
// Status: An optional final status for this span.
Status * Status ` json:"status,omitempty" `
2017-07-23 09:51:42 +02:00
// TimeEvents: The included time events. There can be up to 32
// annotations and 128 network
// events per span.
TimeEvents * TimeEvents ` json:"timeEvents,omitempty" `
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi . ServerResponse ` json:"-" `
2017-05-11 16:39:54 +02:00
// ForceSendFields is a list of field names (e.g. "Attributes") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "Attributes") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * Span ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod Span
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// StackFrame: Represents a single stack frame in a stack trace.
type StackFrame struct {
2017-07-23 09:51:42 +02:00
// ColumnNumber: The column number where the function call appears, if
// available.
// This is important in JavaScript because of its anonymous functions.
2017-05-11 16:39:54 +02:00
ColumnNumber int64 ` json:"columnNumber,omitempty,string" `
2017-07-23 09:51:42 +02:00
// FileName: The name of the source file where the function call appears
// (up to 256
// bytes).
FileName * TruncatableString ` json:"fileName,omitempty" `
2017-05-11 16:39:54 +02:00
2017-07-23 09:51:42 +02:00
// FunctionName: The fully-qualified name that uniquely identifies the
2017-05-11 16:39:54 +02:00
// function or
2017-07-23 09:51:42 +02:00
// method that is active in this frame (up to 1024 bytes).
FunctionName * TruncatableString ` json:"functionName,omitempty" `
2017-05-11 16:39:54 +02:00
2017-07-23 09:51:42 +02:00
// LineNumber: The line number in `file_name` where the function call
// appears.
2017-05-11 16:39:54 +02:00
LineNumber int64 ` json:"lineNumber,omitempty,string" `
2017-07-23 09:51:42 +02:00
// LoadModule: The binary module from where the code was loaded.
2017-05-11 16:39:54 +02:00
LoadModule * Module ` json:"loadModule,omitempty" `
2017-07-23 09:51:42 +02:00
// OriginalFunctionName: An un-mangled function name, if `function_name`
2017-05-11 16:39:54 +02:00
// is
2017-07-23 09:51:42 +02:00
// [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name
// can
// be fully-qualified (up to 1024 bytes).
OriginalFunctionName * TruncatableString ` json:"originalFunctionName,omitempty" `
2017-05-11 16:39:54 +02:00
2017-07-23 09:51:42 +02:00
// SourceVersion: The version of the deployed source code (up to 128
// bytes).
SourceVersion * TruncatableString ` json:"sourceVersion,omitempty" `
2017-05-11 16:39:54 +02:00
// ForceSendFields is a list of field names (e.g. "ColumnNumber") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "ColumnNumber") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * StackFrame ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod StackFrame
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
2017-07-23 09:51:42 +02:00
// StackFrames: A collection of stack frames, which can be truncated.
type StackFrames struct {
// DroppedFramesCount: The number of stack frames that were dropped
// because there
// were too many stack frames.
// If this value is 0, then no stack frames were dropped.
DroppedFramesCount int64 ` json:"droppedFramesCount,omitempty" `
// Frame: Stack frames in this call stack.
Frame [ ] * StackFrame ` json:"frame,omitempty" `
// ForceSendFields is a list of field names (e.g. "DroppedFramesCount")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "DroppedFramesCount") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields [ ] string ` json:"-" `
}
func ( s * StackFrames ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod StackFrames
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// StackTrace: A call stack appearing in a trace.
2017-05-11 16:39:54 +02:00
type StackTrace struct {
2017-07-23 09:51:42 +02:00
// StackFrames: Stack frames in this stack trace. A maximum of 128
// frames are allowed.
StackFrames * StackFrames ` json:"stackFrames,omitempty" `
2017-05-11 16:39:54 +02:00
// StackTraceHashId: The hash ID is used to conserve network bandwidth
// for duplicate
// stack traces within a single trace.
//
// Often multiple spans will have identical stack traces.
2017-07-23 09:51:42 +02:00
// The first occurrence of a stack trace should contain both
2017-05-11 16:39:54 +02:00
// the
// `stackFrame` content and a value in `stackTraceHashId`.
//
// Subsequent spans within the same request can refer
// to that stack trace by only setting `stackTraceHashId`.
StackTraceHashId uint64 ` json:"stackTraceHashId,omitempty,string" `
2017-07-23 09:51:42 +02:00
// ForceSendFields is a list of field names (e.g. "StackFrames") to
2017-05-11 16:39:54 +02:00
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
2017-07-23 09:51:42 +02:00
// NullFields is a list of field names (e.g. "StackFrames") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
2017-05-11 16:39:54 +02:00
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * StackTrace ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod StackTrace
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// Status: The `Status` type defines a logical error model that is
// suitable for different
// programming environments, including REST APIs and RPC APIs. It is
// used by
// [gRPC](https://github.com/grpc). The error model is designed to
// be:
//
// - Simple to use and understand for most users
// - Flexible enough to meet unexpected needs
//
// # Overview
//
// The `Status` message contains three pieces of data: error code, error
// message,
// and error details. The error code should be an enum value
// of
// google.rpc.Code, but it may accept additional error codes if needed.
// The
// error message should be a developer-facing English message that
// helps
// developers *understand* and *resolve* the error. If a localized
// user-facing
// error message is needed, put the localized message in the error
// details or
// localize it in the client. The optional error details may contain
// arbitrary
// information about the error. There is a predefined set of error
// detail types
2017-07-23 09:51:42 +02:00
// in the package `google.rpc` that can be used for common error
2017-05-11 16:39:54 +02:00
// conditions.
//
// # Language mapping
//
// The `Status` message is the logical representation of the error
// model, but it
// is not necessarily the actual wire format. When the `Status` message
// is
// exposed in different client libraries and different wire protocols,
// it can be
// mapped differently. For example, it will likely be mapped to some
// exceptions
// in Java, but more likely mapped to some error codes in C.
//
// # Other uses
//
// The error model and the `Status` message can be used in a variety
// of
// environments, either with or without APIs, to provide a
// consistent developer experience across different
// environments.
//
// Example uses of this error model include:
//
// - Partial errors. If a service needs to return partial errors to the
// client,
// it may embed the `Status` in the normal response to indicate the
// partial
// errors.
//
// - Workflow errors. A typical workflow has multiple steps. Each step
// may
2017-07-23 09:51:42 +02:00
// have a `Status` message for error reporting.
2017-05-11 16:39:54 +02:00
//
// - Batch operations. If a client uses batch request and batch
// response, the
// `Status` message should be used directly inside batch response,
// one for
// each error sub-response.
//
// - Asynchronous operations. If an API call embeds asynchronous
// operation
// results in its response, the status of those operations should
// be
// represented directly using the `Status` message.
//
// - Logging. If some API errors are stored in logs, the message
// `Status` could
// be used directly after any stripping needed for security/privacy
// reasons.
type Status struct {
// Code: The status code, which should be an enum value of
// google.rpc.Code.
Code int64 ` json:"code,omitempty" `
// Details: A list of messages that carry the error details. There will
// be a
// common set of message types for APIs to use.
Details [ ] googleapi . RawMessage ` json:"details,omitempty" `
// Message: A developer-facing error message, which should be in
// English. Any
// user-facing error message should be localized and sent in
// the
// google.rpc.Status.details field, or localized by the client.
Message string ` json:"message,omitempty" `
// ForceSendFields is a list of field names (e.g. "Code") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "Code") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * Status ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod Status
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
2017-07-23 09:51:42 +02:00
// TimeEvent: A time-stamped annotation or network event in the Span.
2017-05-11 16:39:54 +02:00
type TimeEvent struct {
// Annotation: One or more key:value pairs.
Annotation * Annotation ` json:"annotation,omitempty" `
// NetworkEvent: An event describing an RPC message sent/received on the
// network.
NetworkEvent * NetworkEvent ` json:"networkEvent,omitempty" `
2017-07-23 09:51:42 +02:00
// Time: The timestamp indicating the time the event occurred.
Time string ` json:"time,omitempty" `
2017-05-11 16:39:54 +02:00
// ForceSendFields is a list of field names (e.g. "Annotation") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "Annotation") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * TimeEvent ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod TimeEvent
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
2017-07-23 09:51:42 +02:00
// TimeEvents: A collection of `TimeEvent`s. A `TimeEvent` is a
// time-stamped annotation
// on the span, consisting of either user-supplied key:value pairs,
// or
// details of an RPC message sent/received on the network.
type TimeEvents struct {
// DroppedAnnotationsCount: The number of dropped annotations in all the
// included time events.
// If the value is 0, then no annotations were dropped.
DroppedAnnotationsCount int64 ` json:"droppedAnnotationsCount,omitempty" `
// DroppedNetworkEventsCount: The number of dropped network events in
// all the included time events.
// If the value is 0, then no network events were dropped.
DroppedNetworkEventsCount int64 ` json:"droppedNetworkEventsCount,omitempty" `
// TimeEvent: A collection of `TimeEvent`s.
TimeEvent [ ] * TimeEvent ` json:"timeEvent,omitempty" `
// ForceSendFields is a list of field names (e.g.
// "DroppedAnnotationsCount") to unconditionally include in API
// requests. By default, fields with empty values are omitted from API
// requests. However, any non-pointer, non-interface field appearing in
// ForceSendFields will be sent to the server regardless of whether the
// field is empty or not. This may be used to include empty fields in
// Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "DroppedAnnotationsCount")
// to include in API requests with the JSON null value. By default,
// fields with empty values are omitted from API requests. However, any
// field with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields [ ] string ` json:"-" `
}
func ( s * TimeEvents ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod TimeEvents
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
2017-05-11 16:39:54 +02:00
// Trace: A trace describes how long it takes for an application to
// perform some
// operations. It consists of a set of spans, each representing
// an operation and including time information and operation details.
type Trace struct {
2017-07-23 09:51:42 +02:00
// Name: The resource name of the trace in the following format:
//
// projects/[PROJECT_ID]/traces/TRACE_ID is a unique identifier for
// a trace within a project.
// The ID is assigned when the trace is created.
2017-05-11 16:39:54 +02:00
Name string ` json:"name,omitempty" `
// ForceSendFields is a list of field names (e.g. "Name") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "Name") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * Trace ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod Trace
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
2017-07-23 09:51:42 +02:00
// TruncatableString: Represents a string that might be shortened to a
// specified length.
type TruncatableString struct {
// TruncatedByteCount: The number of bytes removed from the original
// string. If this
// value is 0, then the string was not shortened.
TruncatedByteCount int64 ` json:"truncatedByteCount,omitempty" `
// Value: The shortened string. For example, if the original string was
// 500
// bytes long and the limit of the string was 128 bytes, then this
// value contains the first 128 bytes of the 500-byte string. Note
// that
// truncation always happens on the character boundary, to ensure
// that
// truncated string is still valid UTF8. In case of multi-byte
// characters,
// size of truncated string can be less than truncation limit.
Value string ` json:"value,omitempty" `
// ForceSendFields is a list of field names (e.g. "TruncatedByteCount")
// to unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "TruncatedByteCount") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields [ ] string ` json:"-" `
}
func ( s * TruncatableString ) MarshalJSON ( ) ( [ ] byte , error ) {
type noMethod TruncatableString
raw := noMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// method id "cloudtrace.projects.traces.batchWrite":
type ProjectsTracesBatchWriteCall struct {
s * Service
name string
batchwritespansrequest * BatchWriteSpansRequest
urlParams_ gensupport . URLParams
ctx_ context . Context
header_ http . Header
}
// BatchWrite: Sends new spans to Stackdriver Trace or updates existing
// traces. If the
// name of a trace that you send matches that of an existing trace, new
// spans
// are added to the existing trace. Attempt to update existing spans
// results
// undefined behavior. If the name does not match, a new trace is
// created
// with given set of spans.
func ( r * ProjectsTracesService ) BatchWrite ( name string , batchwritespansrequest * BatchWriteSpansRequest ) * ProjectsTracesBatchWriteCall {
c := & ProjectsTracesBatchWriteCall { s : r . s , urlParams_ : make ( gensupport . URLParams ) }
c . name = name
c . batchwritespansrequest = batchwritespansrequest
2017-05-11 16:39:54 +02:00
return c
}
// Fields allows partial responses to be retrieved. See
// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
// for more information.
2017-07-23 09:51:42 +02:00
func ( c * ProjectsTracesBatchWriteCall ) Fields ( s ... googleapi . Field ) * ProjectsTracesBatchWriteCall {
2017-05-11 16:39:54 +02:00
c . urlParams_ . Set ( "fields" , googleapi . CombineFields ( s ) )
return c
}
// Context sets the context to be used in this call's Do method. Any
// pending HTTP request will be aborted if the provided context is
// canceled.
2017-07-23 09:51:42 +02:00
func ( c * ProjectsTracesBatchWriteCall ) Context ( ctx context . Context ) * ProjectsTracesBatchWriteCall {
2017-05-11 16:39:54 +02:00
c . ctx_ = ctx
return c
}
// Header returns an http.Header that can be modified by the caller to
// add HTTP headers to the request.
2017-07-23 09:51:42 +02:00
func ( c * ProjectsTracesBatchWriteCall ) Header ( ) http . Header {
2017-05-11 16:39:54 +02:00
if c . header_ == nil {
c . header_ = make ( http . Header )
}
return c . header_
}
2017-07-23 09:51:42 +02:00
func ( c * ProjectsTracesBatchWriteCall ) doRequest ( alt string ) ( * http . Response , error ) {
2017-05-11 16:39:54 +02:00
reqHeaders := make ( http . Header )
for k , v := range c . header_ {
reqHeaders [ k ] = v
}
reqHeaders . Set ( "User-Agent" , c . s . userAgent ( ) )
var body io . Reader = nil
2017-07-23 09:51:42 +02:00
body , err := googleapi . WithoutDataWrapper . JSONReader ( c . batchwritespansrequest )
2017-05-11 16:39:54 +02:00
if err != nil {
return nil , err
}
reqHeaders . Set ( "Content-Type" , "application/json" )
c . urlParams_ . Set ( "alt" , alt )
2017-07-23 09:51:42 +02:00
urls := googleapi . ResolveRelative ( c . s . BasePath , "v2/{+name}/traces:batchWrite" )
2017-05-11 16:39:54 +02:00
urls += "?" + c . urlParams_ . Encode ( )
req , _ := http . NewRequest ( "POST" , urls , body )
req . Header = reqHeaders
googleapi . Expand ( req . URL , map [ string ] string {
2017-07-23 09:51:42 +02:00
"name" : c . name ,
2017-05-11 16:39:54 +02:00
} )
return gensupport . SendRequest ( c . ctx_ , c . s . client , req )
}
2017-07-23 09:51:42 +02:00
// Do executes the "cloudtrace.projects.traces.batchWrite" call.
2017-05-11 16:39:54 +02:00
// Exactly one of *Empty or error will be non-nil. Any non-2xx status
// code is an error. Response headers are in either
// *Empty.ServerResponse.Header or (if a response was returned at all)
// in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to
// check whether the returned error was because http.StatusNotModified
// was returned.
2017-07-23 09:51:42 +02:00
func ( c * ProjectsTracesBatchWriteCall ) Do ( opts ... googleapi . CallOption ) ( * Empty , error ) {
2017-05-11 16:39:54 +02:00
gensupport . SetOptions ( c . urlParams_ , opts ... )
res , err := c . doRequest ( "json" )
if res != nil && res . StatusCode == http . StatusNotModified {
if res . Body != nil {
res . Body . Close ( )
}
return nil , & googleapi . Error {
Code : res . StatusCode ,
Header : res . Header ,
}
}
if err != nil {
return nil , err
}
defer googleapi . CloseBody ( res )
if err := googleapi . CheckResponse ( res ) ; err != nil {
return nil , err
}
ret := & Empty {
ServerResponse : googleapi . ServerResponse {
Header : res . Header ,
HTTPStatusCode : res . StatusCode ,
} ,
}
target := & ret
if err := json . NewDecoder ( res . Body ) . Decode ( target ) ; err != nil {
return nil , err
}
return ret , nil
// {
2017-07-23 09:51:42 +02:00
// "description": "Sends new spans to Stackdriver Trace or updates existing traces. If the\nname of a trace that you send matches that of an existing trace, new spans\nare added to the existing trace. Attempt to update existing spans results\nundefined behavior. If the name does not match, a new trace is created\nwith given set of spans.",
// "flatPath": "v2/projects/{projectsId}/traces:batchWrite",
2017-05-11 16:39:54 +02:00
// "httpMethod": "POST",
2017-07-23 09:51:42 +02:00
// "id": "cloudtrace.projects.traces.batchWrite",
2017-05-11 16:39:54 +02:00
// "parameterOrder": [
2017-07-23 09:51:42 +02:00
// "name"
2017-05-11 16:39:54 +02:00
// ],
// "parameters": {
2017-07-23 09:51:42 +02:00
// "name": {
// "description": "Required. Name of the project where the spans belong. The format is\n`projects/PROJECT_ID`.",
2017-05-11 16:39:54 +02:00
// "location": "path",
// "pattern": "^projects/[^/]+$",
// "required": true,
// "type": "string"
// }
// },
2017-07-23 09:51:42 +02:00
// "path": "v2/{+name}/traces:batchWrite",
2017-05-11 16:39:54 +02:00
// "request": {
2017-07-23 09:51:42 +02:00
// "$ref": "BatchWriteSpansRequest"
2017-05-11 16:39:54 +02:00
// },
// "response": {
// "$ref": "Empty"
// },
// "scopes": [
// "https://www.googleapis.com/auth/cloud-platform",
// "https://www.googleapis.com/auth/trace.append"
// ]
// }
}
2017-07-23 09:51:42 +02:00
// method id "cloudtrace.projects.traces.list":
2017-05-11 16:39:54 +02:00
type ProjectsTracesListCall struct {
s * Service
parent string
urlParams_ gensupport . URLParams
ifNoneMatch_ string
ctx_ context . Context
header_ http . Header
}
// List: Returns of a list of traces that match the specified filter
// conditions.
func ( r * ProjectsTracesService ) List ( parent string ) * ProjectsTracesListCall {
c := & ProjectsTracesListCall { s : r . s , urlParams_ : make ( gensupport . URLParams ) }
c . parent = parent
return c
}
2017-07-23 09:51:42 +02:00
// EndTime sets the optional parameter "endTime": Do not return traces
// whose start time is later than this time.
2017-05-11 16:39:54 +02:00
func ( c * ProjectsTracesListCall ) EndTime ( endTime string ) * ProjectsTracesListCall {
c . urlParams_ . Set ( "endTime" , endTime )
return c
}
2017-07-23 09:51:42 +02:00
// Filter sets the optional parameter "filter": Opional. Return only
// traces that match this
// [trace filter](/trace/docs/trace-filters). Example:
//
// "label:/http/url root:/_ah/background my_label:17"
2017-05-11 16:39:54 +02:00
func ( c * ProjectsTracesListCall ) Filter ( filter string ) * ProjectsTracesListCall {
c . urlParams_ . Set ( "filter" , filter )
return c
}
2017-07-23 09:51:42 +02:00
// OrderBy sets the optional parameter "orderBy": A single field used to
// sort the returned traces.
// Only the following field names can be used:
2017-05-11 16:39:54 +02:00
//
2017-07-23 09:51:42 +02:00
// * `trace_id`: the trace's ID field
// * `name`: the root span's resource name
// * `duration`: the difference between the root span's start time and
// end time
// * `start`: the start time of the root span
2017-05-11 16:39:54 +02:00
//
2017-07-23 09:51:42 +02:00
// Sorting is in ascending order unless `desc` is appended to the sort
// field name.
// Example: "name desc").
2017-05-11 16:39:54 +02:00
func ( c * ProjectsTracesListCall ) OrderBy ( orderBy string ) * ProjectsTracesListCall {
c . urlParams_ . Set ( "orderBy" , orderBy )
return c
}
2017-07-23 09:51:42 +02:00
// PageSize sets the optional parameter "pageSize": 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, even if
// fewer than
// the maximum number of results is returned by this request.
2017-05-11 16:39:54 +02:00
func ( c * ProjectsTracesListCall ) PageSize ( pageSize int64 ) * ProjectsTracesListCall {
c . urlParams_ . Set ( "pageSize" , fmt . Sprint ( pageSize ) )
return c
}
2017-07-23 09:51:42 +02:00
// PageToken sets the optional parameter "pageToken": 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.
2017-05-11 16:39:54 +02:00
func ( c * ProjectsTracesListCall ) PageToken ( pageToken string ) * ProjectsTracesListCall {
c . urlParams_ . Set ( "pageToken" , pageToken )
return c
}
2017-07-23 09:51:42 +02:00
// StartTime sets the optional parameter "startTime": Do not return
// traces whose end time is earlier than this time.
2017-05-11 16:39:54 +02:00
func ( c * ProjectsTracesListCall ) StartTime ( startTime string ) * ProjectsTracesListCall {
c . urlParams_ . Set ( "startTime" , startTime )
return c
}
// Fields allows partial responses to be retrieved. See
// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
// for more information.
func ( c * ProjectsTracesListCall ) Fields ( s ... googleapi . Field ) * ProjectsTracesListCall {
c . urlParams_ . Set ( "fields" , googleapi . CombineFields ( s ) )
return c
}
// IfNoneMatch sets the optional parameter which makes the operation
// fail if the object's ETag matches the given value. This is useful for
// getting updates only after the object has changed since the last
// request. Use googleapi.IsNotModified to check whether the response
// error from Do is the result of In-None-Match.
func ( c * ProjectsTracesListCall ) IfNoneMatch ( entityTag string ) * ProjectsTracesListCall {
c . ifNoneMatch_ = entityTag
return c
}
// Context sets the context to be used in this call's Do method. Any
// pending HTTP request will be aborted if the provided context is
// canceled.
func ( c * ProjectsTracesListCall ) Context ( ctx context . Context ) * ProjectsTracesListCall {
c . ctx_ = ctx
return c
}
// Header returns an http.Header that can be modified by the caller to
// add HTTP headers to the request.
func ( c * ProjectsTracesListCall ) Header ( ) http . Header {
if c . header_ == nil {
c . header_ = make ( http . Header )
}
return c . header_
}
func ( c * ProjectsTracesListCall ) doRequest ( alt string ) ( * http . Response , error ) {
reqHeaders := make ( http . Header )
for k , v := range c . header_ {
reqHeaders [ k ] = v
}
reqHeaders . Set ( "User-Agent" , c . s . userAgent ( ) )
if c . ifNoneMatch_ != "" {
reqHeaders . Set ( "If-None-Match" , c . ifNoneMatch_ )
}
var body io . Reader = nil
c . urlParams_ . Set ( "alt" , alt )
2017-07-23 09:51:42 +02:00
urls := googleapi . ResolveRelative ( c . s . BasePath , "v2/{+parent}/traces" )
2017-05-11 16:39:54 +02:00
urls += "?" + c . urlParams_ . Encode ( )
req , _ := http . NewRequest ( "GET" , urls , body )
req . Header = reqHeaders
googleapi . Expand ( req . URL , map [ string ] string {
"parent" : c . parent ,
} )
return gensupport . SendRequest ( c . ctx_ , c . s . client , req )
}
2017-07-23 09:51:42 +02:00
// Do executes the "cloudtrace.projects.traces.list" call.
2017-05-11 16:39:54 +02:00
// Exactly one of *ListTracesResponse or error will be non-nil. Any
// non-2xx status code is an error. Response headers are in either
// *ListTracesResponse.ServerResponse.Header or (if a response was
// returned at all) in error.(*googleapi.Error).Header. Use
// googleapi.IsNotModified to check whether the returned error was
// because http.StatusNotModified was returned.
func ( c * ProjectsTracesListCall ) Do ( opts ... googleapi . CallOption ) ( * ListTracesResponse , error ) {
gensupport . SetOptions ( c . urlParams_ , opts ... )
res , err := c . doRequest ( "json" )
if res != nil && res . StatusCode == http . StatusNotModified {
if res . Body != nil {
res . Body . Close ( )
}
return nil , & googleapi . Error {
Code : res . StatusCode ,
Header : res . Header ,
}
}
if err != nil {
return nil , err
}
defer googleapi . CloseBody ( res )
if err := googleapi . CheckResponse ( res ) ; err != nil {
return nil , err
}
ret := & ListTracesResponse {
ServerResponse : googleapi . ServerResponse {
Header : res . Header ,
HTTPStatusCode : res . StatusCode ,
} ,
}
target := & ret
if err := json . NewDecoder ( res . Body ) . Decode ( target ) ; err != nil {
return nil , err
}
return ret , nil
// {
// "description": "Returns of a list of traces that match the specified filter conditions.",
2017-07-23 09:51:42 +02:00
// "flatPath": "v2/projects/{projectsId}/traces",
2017-05-11 16:39:54 +02:00
// "httpMethod": "GET",
2017-07-23 09:51:42 +02:00
// "id": "cloudtrace.projects.traces.list",
2017-05-11 16:39:54 +02:00
// "parameterOrder": [
// "parent"
// ],
// "parameters": {
// "endTime": {
2017-07-23 09:51:42 +02:00
// "description": "Optional. Do not return traces whose start time is later than this time.",
2017-05-11 16:39:54 +02:00
// "format": "google-datetime",
// "location": "query",
// "type": "string"
// },
// "filter": {
2017-07-23 09:51:42 +02:00
// "description": "Opional. Return only traces that match this\n[trace filter](/trace/docs/trace-filters). Example:\n\n \"label:/http/url root:/_ah/background my_label:17\"",
2017-05-11 16:39:54 +02:00
// "location": "query",
// "type": "string"
// },
// "orderBy": {
2017-07-23 09:51:42 +02:00
// "description": "Optional. A single field used to sort the returned traces.\nOnly the following field names can be used:\n\n* `trace_id`: the trace's ID field\n* `name`: the root span's resource name\n* `duration`: the difference between the root span's start time and end time\n* `start`: the start time of the root span\n\nSorting is in ascending order unless `desc` is appended to the sort field name.\nExample: `\"name desc\"`).",
2017-05-11 16:39:54 +02:00
// "location": "query",
// "type": "string"
// },
// "pageSize": {
2017-07-23 09:51:42 +02:00
// "description": "Optional. The maximum number of results to return from this request.\nNon-positive values are ignored. The presence of `next_page_token` in the\nresponse indicates that more results might be available, even if fewer than\nthe maximum number of results is returned by this request.",
2017-05-11 16:39:54 +02:00
// "format": "int32",
// "location": "query",
// "type": "integer"
// },
// "pageToken": {
2017-07-23 09:51:42 +02:00
// "description": "Optional. If present, then retrieve the next batch of results from the\npreceding call to this method. `page_token` must be the value of\n`next_page_token` from the previous response. The values of other method\nparameters should be identical to those in the previous call.",
2017-05-11 16:39:54 +02:00
// "location": "query",
// "type": "string"
// },
// "parent": {
2017-07-23 09:51:42 +02:00
// "description": "Required. The project where the trace data is stored. The format\nis `projects/PROJECT_ID`.",
2017-05-11 16:39:54 +02:00
// "location": "path",
// "pattern": "^projects/[^/]+$",
// "required": true,
// "type": "string"
// },
// "startTime": {
2017-07-23 09:51:42 +02:00
// "description": "Optional. Do not return traces whose end time is earlier than this time.",
2017-05-11 16:39:54 +02:00
// "format": "google-datetime",
// "location": "query",
// "type": "string"
// }
// },
2017-07-23 09:51:42 +02:00
// "path": "v2/{+parent}/traces",
2017-05-11 16:39:54 +02:00
// "response": {
// "$ref": "ListTracesResponse"
// },
// "scopes": [
// "https://www.googleapis.com/auth/cloud-platform",
// "https://www.googleapis.com/auth/trace.readonly"
// ]
// }
}
// Pages invokes f for each page of results.
// A non-nil error returned from f will halt the iteration.
// The provided context supersedes any context provided to the Context method.
func ( c * ProjectsTracesListCall ) Pages ( ctx context . Context , f func ( * ListTracesResponse ) error ) error {
c . ctx_ = ctx
defer c . PageToken ( c . urlParams_ . Get ( "pageToken" ) ) // reset paging to original point
for {
x , err := c . Do ( )
if err != nil {
return err
}
if err := f ( x ) ; err != nil {
return err
}
if x . NextPageToken == "" {
return nil
}
c . PageToken ( x . NextPageToken )
}
}
2017-07-23 09:51:42 +02:00
// method id "cloudtrace.projects.traces.listSpans":
2017-05-11 16:39:54 +02:00
type ProjectsTracesListSpansCall struct {
s * Service
2017-07-23 09:51:42 +02:00
parent string
2017-05-11 16:39:54 +02:00
urlParams_ gensupport . URLParams
ifNoneMatch_ string
ctx_ context . Context
header_ http . Header
}
// ListSpans: Returns a list of spans within a trace.
2017-07-23 09:51:42 +02:00
func ( r * ProjectsTracesService ) ListSpans ( parent string ) * ProjectsTracesListSpansCall {
2017-05-11 16:39:54 +02:00
c := & ProjectsTracesListSpansCall { s : r . s , urlParams_ : make ( gensupport . URLParams ) }
2017-07-23 09:51:42 +02:00
c . parent = parent
2017-05-11 16:39:54 +02:00
return c
}
2017-07-23 09:51:42 +02:00
// PageToken sets the optional parameter "pageToken": 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.
2017-05-11 16:39:54 +02:00
func ( c * ProjectsTracesListSpansCall ) PageToken ( pageToken string ) * ProjectsTracesListSpansCall {
c . urlParams_ . Set ( "pageToken" , pageToken )
return c
}
// Fields allows partial responses to be retrieved. See
// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
// for more information.
func ( c * ProjectsTracesListSpansCall ) Fields ( s ... googleapi . Field ) * ProjectsTracesListSpansCall {
c . urlParams_ . Set ( "fields" , googleapi . CombineFields ( s ) )
return c
}
// IfNoneMatch sets the optional parameter which makes the operation
// fail if the object's ETag matches the given value. This is useful for
// getting updates only after the object has changed since the last
// request. Use googleapi.IsNotModified to check whether the response
// error from Do is the result of In-None-Match.
func ( c * ProjectsTracesListSpansCall ) IfNoneMatch ( entityTag string ) * ProjectsTracesListSpansCall {
c . ifNoneMatch_ = entityTag
return c
}
// Context sets the context to be used in this call's Do method. Any
// pending HTTP request will be aborted if the provided context is
// canceled.
func ( c * ProjectsTracesListSpansCall ) Context ( ctx context . Context ) * ProjectsTracesListSpansCall {
c . ctx_ = ctx
return c
}
// Header returns an http.Header that can be modified by the caller to
// add HTTP headers to the request.
func ( c * ProjectsTracesListSpansCall ) Header ( ) http . Header {
if c . header_ == nil {
c . header_ = make ( http . Header )
}
return c . header_
}
func ( c * ProjectsTracesListSpansCall ) doRequest ( alt string ) ( * http . Response , error ) {
reqHeaders := make ( http . Header )
for k , v := range c . header_ {
reqHeaders [ k ] = v
}
reqHeaders . Set ( "User-Agent" , c . s . userAgent ( ) )
if c . ifNoneMatch_ != "" {
reqHeaders . Set ( "If-None-Match" , c . ifNoneMatch_ )
}
var body io . Reader = nil
c . urlParams_ . Set ( "alt" , alt )
2017-07-23 09:51:42 +02:00
urls := googleapi . ResolveRelative ( c . s . BasePath , "v2/{+parent}:listSpans" )
2017-05-11 16:39:54 +02:00
urls += "?" + c . urlParams_ . Encode ( )
req , _ := http . NewRequest ( "GET" , urls , body )
req . Header = reqHeaders
googleapi . Expand ( req . URL , map [ string ] string {
2017-07-23 09:51:42 +02:00
"parent" : c . parent ,
2017-05-11 16:39:54 +02:00
} )
return gensupport . SendRequest ( c . ctx_ , c . s . client , req )
}
2017-07-23 09:51:42 +02:00
// Do executes the "cloudtrace.projects.traces.listSpans" call.
2017-05-11 16:39:54 +02:00
// Exactly one of *ListSpansResponse or error will be non-nil. Any
// non-2xx status code is an error. Response headers are in either
// *ListSpansResponse.ServerResponse.Header or (if a response was
// returned at all) in error.(*googleapi.Error).Header. Use
// googleapi.IsNotModified to check whether the returned error was
// because http.StatusNotModified was returned.
func ( c * ProjectsTracesListSpansCall ) Do ( opts ... googleapi . CallOption ) ( * ListSpansResponse , error ) {
gensupport . SetOptions ( c . urlParams_ , opts ... )
res , err := c . doRequest ( "json" )
if res != nil && res . StatusCode == http . StatusNotModified {
if res . Body != nil {
res . Body . Close ( )
}
return nil , & googleapi . Error {
Code : res . StatusCode ,
Header : res . Header ,
}
}
if err != nil {
return nil , err
}
defer googleapi . CloseBody ( res )
if err := googleapi . CheckResponse ( res ) ; err != nil {
return nil , err
}
ret := & ListSpansResponse {
ServerResponse : googleapi . ServerResponse {
Header : res . Header ,
HTTPStatusCode : res . StatusCode ,
} ,
}
target := & ret
if err := json . NewDecoder ( res . Body ) . Decode ( target ) ; err != nil {
return nil , err
}
return ret , nil
// {
// "description": "Returns a list of spans within a trace.",
2017-07-23 09:51:42 +02:00
// "flatPath": "v2/projects/{projectsId}/traces/{tracesId}:listSpans",
2017-05-11 16:39:54 +02:00
// "httpMethod": "GET",
2017-07-23 09:51:42 +02:00
// "id": "cloudtrace.projects.traces.listSpans",
2017-05-11 16:39:54 +02:00
// "parameterOrder": [
2017-07-23 09:51:42 +02:00
// "parent"
2017-05-11 16:39:54 +02:00
// ],
// "parameters": {
2017-07-23 09:51:42 +02:00
// "pageToken": {
// "description": "Optional. If present, then retrieve the next batch of results from the\npreceding call to this method. `page_token` must be the value of\n`next_page_token` from the previous response. The values of other method\nparameters should be identical to those in the previous call.",
// "location": "query",
// "type": "string"
// },
// "parent": {
// "description": "Required: The resource name of the trace containing the spans to list.\nThe format is `projects/PROJECT_ID/traces/TRACE_ID`.",
2017-05-11 16:39:54 +02:00
// "location": "path",
// "pattern": "^projects/[^/]+/traces/[^/]+$",
// "required": true,
// "type": "string"
// }
// },
2017-07-23 09:51:42 +02:00
// "path": "v2/{+parent}:listSpans",
2017-05-11 16:39:54 +02:00
// "response": {
// "$ref": "ListSpansResponse"
// },
// "scopes": [
// "https://www.googleapis.com/auth/cloud-platform",
// "https://www.googleapis.com/auth/trace.readonly"
// ]
// }
}
// Pages invokes f for each page of results.
// A non-nil error returned from f will halt the iteration.
// The provided context supersedes any context provided to the Context method.
func ( c * ProjectsTracesListSpansCall ) Pages ( ctx context . Context , f func ( * ListSpansResponse ) error ) error {
c . ctx_ = ctx
defer c . PageToken ( c . urlParams_ . Get ( "pageToken" ) ) // reset paging to original point
for {
x , err := c . Do ( )
if err != nil {
return err
}
if err := f ( x ) ; err != nil {
return err
}
if x . NextPageToken == "" {
return nil
}
c . PageToken ( x . NextPageToken )
}
}
2017-07-23 09:51:42 +02:00
// method id "cloudtrace.projects.traces.spans.create":
type ProjectsTracesSpansCreateCall struct {
s * Service
nameid string
span * Span
urlParams_ gensupport . URLParams
ctx_ context . Context
header_ http . Header
}
// Create: Creates a new Span.
func ( r * ProjectsTracesSpansService ) Create ( nameid string , span * Span ) * ProjectsTracesSpansCreateCall {
c := & ProjectsTracesSpansCreateCall { s : r . s , urlParams_ : make ( gensupport . URLParams ) }
c . nameid = nameid
c . span = span
return c
}
// Fields allows partial responses to be retrieved. See
// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
// for more information.
func ( c * ProjectsTracesSpansCreateCall ) Fields ( s ... googleapi . Field ) * ProjectsTracesSpansCreateCall {
c . urlParams_ . Set ( "fields" , googleapi . CombineFields ( s ) )
return c
}
// Context sets the context to be used in this call's Do method. Any
// pending HTTP request will be aborted if the provided context is
// canceled.
func ( c * ProjectsTracesSpansCreateCall ) Context ( ctx context . Context ) * ProjectsTracesSpansCreateCall {
c . ctx_ = ctx
return c
}
// Header returns an http.Header that can be modified by the caller to
// add HTTP headers to the request.
func ( c * ProjectsTracesSpansCreateCall ) Header ( ) http . Header {
if c . header_ == nil {
c . header_ = make ( http . Header )
}
return c . header_
}
func ( c * ProjectsTracesSpansCreateCall ) doRequest ( alt string ) ( * http . Response , error ) {
reqHeaders := make ( http . Header )
for k , v := range c . header_ {
reqHeaders [ k ] = v
}
reqHeaders . Set ( "User-Agent" , c . s . userAgent ( ) )
var body io . Reader = nil
body , err := googleapi . WithoutDataWrapper . JSONReader ( c . span )
if err != nil {
return nil , err
}
reqHeaders . Set ( "Content-Type" , "application/json" )
c . urlParams_ . Set ( "alt" , alt )
urls := googleapi . ResolveRelative ( c . s . BasePath , "v2/{+name}" )
urls += "?" + c . urlParams_ . Encode ( )
req , _ := http . NewRequest ( "PUT" , urls , body )
req . Header = reqHeaders
googleapi . Expand ( req . URL , map [ string ] string {
"name" : c . nameid ,
} )
return gensupport . SendRequest ( c . ctx_ , c . s . client , req )
}
// Do executes the "cloudtrace.projects.traces.spans.create" call.
// Exactly one of *Span or error will be non-nil. Any non-2xx status
// code is an error. Response headers are in either
// *Span.ServerResponse.Header or (if a response was returned at all) in
// error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check
// whether the returned error was because http.StatusNotModified was
// returned.
func ( c * ProjectsTracesSpansCreateCall ) Do ( opts ... googleapi . CallOption ) ( * Span , error ) {
gensupport . SetOptions ( c . urlParams_ , opts ... )
res , err := c . doRequest ( "json" )
if res != nil && res . StatusCode == http . StatusNotModified {
if res . Body != nil {
res . Body . Close ( )
}
return nil , & googleapi . Error {
Code : res . StatusCode ,
Header : res . Header ,
}
}
if err != nil {
return nil , err
}
defer googleapi . CloseBody ( res )
if err := googleapi . CheckResponse ( res ) ; err != nil {
return nil , err
}
ret := & Span {
ServerResponse : googleapi . ServerResponse {
Header : res . Header ,
HTTPStatusCode : res . StatusCode ,
} ,
}
target := & ret
if err := json . NewDecoder ( res . Body ) . Decode ( target ) ; err != nil {
return nil , err
}
return ret , nil
// {
// "description": "Creates a new Span.",
// "flatPath": "v2/projects/{projectsId}/traces/{tracesId}/spans/{spansId}",
// "httpMethod": "PUT",
// "id": "cloudtrace.projects.traces.spans.create",
// "parameterOrder": [
// "name"
// ],
// "parameters": {
// "name": {
// "description": "The resource name of the span in the following format:\n\n projects/[PROJECT_ID]traces/[TRACE_ID]/spans/SPAN_ID is a unique identifier for a trace within a project.\n[SPAN_ID] is a unique identifier for a span within a trace,\nassigned when the span is created.",
// "location": "path",
// "pattern": "^projects/[^/]+/traces/[^/]+/spans/[^/]+$",
// "required": true,
// "type": "string"
// }
// },
// "path": "v2/{+name}",
// "request": {
// "$ref": "Span"
// },
// "response": {
// "$ref": "Span"
// },
// "scopes": [
// "https://www.googleapis.com/auth/cloud-platform",
// "https://www.googleapis.com/auth/trace.append"
// ]
// }
}