Documentation ¶
Overview ¶
Package xray provides a client for AWS X-Ray.
Index ¶
- Constants
- type Alias
- type AnnotationValue
- type BackendConnectionErrors
- func (s BackendConnectionErrors) GoString() string
- func (s *BackendConnectionErrors) SetConnectionRefusedCount(v int64) *BackendConnectionErrors
- func (s *BackendConnectionErrors) SetHTTPCode4XXCount(v int64) *BackendConnectionErrors
- func (s *BackendConnectionErrors) SetHTTPCode5XXCount(v int64) *BackendConnectionErrors
- func (s *BackendConnectionErrors) SetOtherCount(v int64) *BackendConnectionErrors
- func (s *BackendConnectionErrors) SetTimeoutCount(v int64) *BackendConnectionErrors
- func (s *BackendConnectionErrors) SetUnknownHostCount(v int64) *BackendConnectionErrors
- func (s BackendConnectionErrors) String() string
- type BatchGetTracesInput
- type BatchGetTracesOutput
- func (s BatchGetTracesOutput) GoString() string
- func (s *BatchGetTracesOutput) SetNextToken(v string) *BatchGetTracesOutput
- func (s *BatchGetTracesOutput) SetTraces(v []*Trace) *BatchGetTracesOutput
- func (s *BatchGetTracesOutput) SetUnprocessedTraceIds(v []*string) *BatchGetTracesOutput
- func (s BatchGetTracesOutput) String() string
- type Edge
- func (s Edge) GoString() string
- func (s *Edge) SetAliases(v []*Alias) *Edge
- func (s *Edge) SetEndTime(v time.Time) *Edge
- func (s *Edge) SetReferenceId(v int64) *Edge
- func (s *Edge) SetResponseTimeHistogram(v []*HistogramEntry) *Edge
- func (s *Edge) SetStartTime(v time.Time) *Edge
- func (s *Edge) SetSummaryStatistics(v *EdgeStatistics) *Edge
- func (s Edge) String() string
- type EdgeStatistics
- func (s EdgeStatistics) GoString() string
- func (s *EdgeStatistics) SetErrorStatistics(v *ErrorStatistics) *EdgeStatistics
- func (s *EdgeStatistics) SetFaultStatistics(v *FaultStatistics) *EdgeStatistics
- func (s *EdgeStatistics) SetOkCount(v int64) *EdgeStatistics
- func (s *EdgeStatistics) SetTotalCount(v int64) *EdgeStatistics
- func (s *EdgeStatistics) SetTotalResponseTime(v float64) *EdgeStatistics
- func (s EdgeStatistics) String() string
- type ErrorStatistics
- type FaultStatistics
- type GetServiceGraphInput
- func (s GetServiceGraphInput) GoString() string
- func (s *GetServiceGraphInput) SetEndTime(v time.Time) *GetServiceGraphInput
- func (s *GetServiceGraphInput) SetNextToken(v string) *GetServiceGraphInput
- func (s *GetServiceGraphInput) SetStartTime(v time.Time) *GetServiceGraphInput
- func (s GetServiceGraphInput) String() string
- func (s *GetServiceGraphInput) Validate() error
- type GetServiceGraphOutput
- func (s GetServiceGraphOutput) GoString() string
- func (s *GetServiceGraphOutput) SetEndTime(v time.Time) *GetServiceGraphOutput
- func (s *GetServiceGraphOutput) SetNextToken(v string) *GetServiceGraphOutput
- func (s *GetServiceGraphOutput) SetServices(v []*Service) *GetServiceGraphOutput
- func (s *GetServiceGraphOutput) SetStartTime(v time.Time) *GetServiceGraphOutput
- func (s GetServiceGraphOutput) String() string
- type GetTraceGraphInput
- type GetTraceGraphOutput
- type GetTraceSummariesInput
- func (s GetTraceSummariesInput) GoString() string
- func (s *GetTraceSummariesInput) SetEndTime(v time.Time) *GetTraceSummariesInput
- func (s *GetTraceSummariesInput) SetFilterExpression(v string) *GetTraceSummariesInput
- func (s *GetTraceSummariesInput) SetNextToken(v string) *GetTraceSummariesInput
- func (s *GetTraceSummariesInput) SetSampling(v bool) *GetTraceSummariesInput
- func (s *GetTraceSummariesInput) SetStartTime(v time.Time) *GetTraceSummariesInput
- func (s GetTraceSummariesInput) String() string
- func (s *GetTraceSummariesInput) Validate() error
- type GetTraceSummariesOutput
- func (s GetTraceSummariesOutput) GoString() string
- func (s *GetTraceSummariesOutput) SetApproximateTime(v time.Time) *GetTraceSummariesOutput
- func (s *GetTraceSummariesOutput) SetNextToken(v string) *GetTraceSummariesOutput
- func (s *GetTraceSummariesOutput) SetTraceSummaries(v []*TraceSummary) *GetTraceSummariesOutput
- func (s *GetTraceSummariesOutput) SetTracesProcessedCount(v int64) *GetTraceSummariesOutput
- func (s GetTraceSummariesOutput) String() string
- type HistogramEntry
- type Http
- type PutTelemetryRecordsInput
- func (s PutTelemetryRecordsInput) GoString() string
- func (s *PutTelemetryRecordsInput) SetEC2InstanceId(v string) *PutTelemetryRecordsInput
- func (s *PutTelemetryRecordsInput) SetHostname(v string) *PutTelemetryRecordsInput
- func (s *PutTelemetryRecordsInput) SetResourceARN(v string) *PutTelemetryRecordsInput
- func (s *PutTelemetryRecordsInput) SetTelemetryRecords(v []*TelemetryRecord) *PutTelemetryRecordsInput
- func (s PutTelemetryRecordsInput) String() string
- func (s *PutTelemetryRecordsInput) Validate() error
- type PutTelemetryRecordsOutput
- type PutTraceSegmentsInput
- type PutTraceSegmentsOutput
- type Segment
- type Service
- func (s Service) GoString() string
- func (s *Service) SetAccountId(v string) *Service
- func (s *Service) SetDurationHistogram(v []*HistogramEntry) *Service
- func (s *Service) SetEdges(v []*Edge) *Service
- func (s *Service) SetEndTime(v time.Time) *Service
- func (s *Service) SetName(v string) *Service
- func (s *Service) SetNames(v []*string) *Service
- func (s *Service) SetReferenceId(v int64) *Service
- func (s *Service) SetRoot(v bool) *Service
- func (s *Service) SetStartTime(v time.Time) *Service
- func (s *Service) SetState(v string) *Service
- func (s *Service) SetSummaryStatistics(v *ServiceStatistics) *Service
- func (s *Service) SetType(v string) *Service
- func (s Service) String() string
- type ServiceId
- type ServiceStatistics
- func (s ServiceStatistics) GoString() string
- func (s *ServiceStatistics) SetErrorStatistics(v *ErrorStatistics) *ServiceStatistics
- func (s *ServiceStatistics) SetFaultStatistics(v *FaultStatistics) *ServiceStatistics
- func (s *ServiceStatistics) SetOkCount(v int64) *ServiceStatistics
- func (s *ServiceStatistics) SetTotalCount(v int64) *ServiceStatistics
- func (s *ServiceStatistics) SetTotalResponseTime(v float64) *ServiceStatistics
- func (s ServiceStatistics) String() string
- type TelemetryRecord
- func (s TelemetryRecord) GoString() string
- func (s *TelemetryRecord) SetBackendConnectionErrors(v *BackendConnectionErrors) *TelemetryRecord
- func (s *TelemetryRecord) SetSegmentsReceivedCount(v int64) *TelemetryRecord
- func (s *TelemetryRecord) SetSegmentsRejectedCount(v int64) *TelemetryRecord
- func (s *TelemetryRecord) SetSegmentsSentCount(v int64) *TelemetryRecord
- func (s *TelemetryRecord) SetSegmentsSpilloverCount(v int64) *TelemetryRecord
- func (s *TelemetryRecord) SetTimestamp(v time.Time) *TelemetryRecord
- func (s TelemetryRecord) String() string
- type Trace
- type TraceSummary
- func (s TraceSummary) GoString() string
- func (s *TraceSummary) SetAnnotations(v map[string][]*ValueWithServiceIds) *TraceSummary
- func (s *TraceSummary) SetDuration(v float64) *TraceSummary
- func (s *TraceSummary) SetHasError(v bool) *TraceSummary
- func (s *TraceSummary) SetHasFault(v bool) *TraceSummary
- func (s *TraceSummary) SetHasThrottle(v bool) *TraceSummary
- func (s *TraceSummary) SetHttp(v *Http) *TraceSummary
- func (s *TraceSummary) SetId(v string) *TraceSummary
- func (s *TraceSummary) SetIsPartial(v bool) *TraceSummary
- func (s *TraceSummary) SetResponseTime(v float64) *TraceSummary
- func (s *TraceSummary) SetServiceIds(v []*ServiceId) *TraceSummary
- func (s *TraceSummary) SetUsers(v []*TraceUser) *TraceSummary
- func (s TraceSummary) String() string
- type TraceUser
- type UnprocessedTraceSegment
- func (s UnprocessedTraceSegment) GoString() string
- func (s *UnprocessedTraceSegment) SetErrorCode(v string) *UnprocessedTraceSegment
- func (s *UnprocessedTraceSegment) SetId(v string) *UnprocessedTraceSegment
- func (s *UnprocessedTraceSegment) SetMessage(v string) *UnprocessedTraceSegment
- func (s UnprocessedTraceSegment) String() string
- type ValueWithServiceIds
- type XRay
- func (c *XRay) BatchGetTraces(input *BatchGetTracesInput) (*BatchGetTracesOutput, error)
- func (c *XRay) BatchGetTracesRequest(input *BatchGetTracesInput) (req *request.Request, output *BatchGetTracesOutput)
- func (c *XRay) BatchGetTracesWithContext(ctx aws.Context, input *BatchGetTracesInput, opts ...request.Option) (*BatchGetTracesOutput, error)
- func (c *XRay) GetServiceGraph(input *GetServiceGraphInput) (*GetServiceGraphOutput, error)
- func (c *XRay) GetServiceGraphRequest(input *GetServiceGraphInput) (req *request.Request, output *GetServiceGraphOutput)
- func (c *XRay) GetServiceGraphWithContext(ctx aws.Context, input *GetServiceGraphInput, opts ...request.Option) (*GetServiceGraphOutput, error)
- func (c *XRay) GetTraceGraph(input *GetTraceGraphInput) (*GetTraceGraphOutput, error)
- func (c *XRay) GetTraceGraphRequest(input *GetTraceGraphInput) (req *request.Request, output *GetTraceGraphOutput)
- func (c *XRay) GetTraceGraphWithContext(ctx aws.Context, input *GetTraceGraphInput, opts ...request.Option) (*GetTraceGraphOutput, error)
- func (c *XRay) GetTraceSummaries(input *GetTraceSummariesInput) (*GetTraceSummariesOutput, error)
- func (c *XRay) GetTraceSummariesRequest(input *GetTraceSummariesInput) (req *request.Request, output *GetTraceSummariesOutput)
- func (c *XRay) GetTraceSummariesWithContext(ctx aws.Context, input *GetTraceSummariesInput, opts ...request.Option) (*GetTraceSummariesOutput, error)
- func (c *XRay) PutTelemetryRecords(input *PutTelemetryRecordsInput) (*PutTelemetryRecordsOutput, error)
- func (c *XRay) PutTelemetryRecordsRequest(input *PutTelemetryRecordsInput) (req *request.Request, output *PutTelemetryRecordsOutput)
- func (c *XRay) PutTelemetryRecordsWithContext(ctx aws.Context, input *PutTelemetryRecordsInput, opts ...request.Option) (*PutTelemetryRecordsOutput, error)
- func (c *XRay) PutTraceSegments(input *PutTraceSegmentsInput) (*PutTraceSegmentsOutput, error)
- func (c *XRay) PutTraceSegmentsRequest(input *PutTraceSegmentsInput) (req *request.Request, output *PutTraceSegmentsOutput)
- func (c *XRay) PutTraceSegmentsWithContext(ctx aws.Context, input *PutTraceSegmentsInput, opts ...request.Option) (*PutTraceSegmentsOutput, error)
Examples ¶
Constants ¶
const ( // ErrCodeInvalidRequestException for service response error code // "InvalidRequestException". // // The request is missing required parameters or has invalid parameters. ErrCodeInvalidRequestException = "InvalidRequestException" // ErrCodeThrottledException for service response error code // "ThrottledException". // // The request exceeds the maximum number of requests per second. ErrCodeThrottledException = "ThrottledException" )
const ( ServiceName = "xray" // Service endpoint prefix API calls made to. EndpointsID = ServiceName // Service ID for Regions and Endpoints metadata. )
Service information constants
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Alias ¶
type Alias struct { // The canonical name of the alias. Name *string `type:"string"` // A list of names for the alias, including the canonical name. Names []*string `type:"list"` // The type of the alias. Type *string `type:"string"` // contains filtered or unexported fields }
An alias for an edge. Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/Alias
type AnnotationValue ¶
type AnnotationValue struct { // Value for a Boolean annotation. BooleanValue *bool `type:"boolean"` // Value for a Number annotation. NumberValue *float64 `type:"double"` // Value for a String annotation. StringValue *string `type:"string"` // contains filtered or unexported fields }
Value of a segment annotation. Has one of three value types: Number, Boolean or String. Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/AnnotationValue
func (AnnotationValue) GoString ¶
func (s AnnotationValue) GoString() string
GoString returns the string representation
func (*AnnotationValue) SetBooleanValue ¶
func (s *AnnotationValue) SetBooleanValue(v bool) *AnnotationValue
SetBooleanValue sets the BooleanValue field's value.
func (*AnnotationValue) SetNumberValue ¶
func (s *AnnotationValue) SetNumberValue(v float64) *AnnotationValue
SetNumberValue sets the NumberValue field's value.
func (*AnnotationValue) SetStringValue ¶
func (s *AnnotationValue) SetStringValue(v string) *AnnotationValue
SetStringValue sets the StringValue field's value.
func (AnnotationValue) String ¶
func (s AnnotationValue) String() string
String returns the string representation
type BackendConnectionErrors ¶
type BackendConnectionErrors struct { ConnectionRefusedCount *int64 `type:"integer"` HTTPCode4XXCount *int64 `type:"integer"` HTTPCode5XXCount *int64 `type:"integer"` OtherCount *int64 `type:"integer"` TimeoutCount *int64 `type:"integer"` UnknownHostCount *int64 `type:"integer"` // contains filtered or unexported fields }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/BackendConnectionErrors
func (BackendConnectionErrors) GoString ¶
func (s BackendConnectionErrors) GoString() string
GoString returns the string representation
func (*BackendConnectionErrors) SetConnectionRefusedCount ¶
func (s *BackendConnectionErrors) SetConnectionRefusedCount(v int64) *BackendConnectionErrors
SetConnectionRefusedCount sets the ConnectionRefusedCount field's value.
func (*BackendConnectionErrors) SetHTTPCode4XXCount ¶
func (s *BackendConnectionErrors) SetHTTPCode4XXCount(v int64) *BackendConnectionErrors
SetHTTPCode4XXCount sets the HTTPCode4XXCount field's value.
func (*BackendConnectionErrors) SetHTTPCode5XXCount ¶
func (s *BackendConnectionErrors) SetHTTPCode5XXCount(v int64) *BackendConnectionErrors
SetHTTPCode5XXCount sets the HTTPCode5XXCount field's value.
func (*BackendConnectionErrors) SetOtherCount ¶
func (s *BackendConnectionErrors) SetOtherCount(v int64) *BackendConnectionErrors
SetOtherCount sets the OtherCount field's value.
func (*BackendConnectionErrors) SetTimeoutCount ¶
func (s *BackendConnectionErrors) SetTimeoutCount(v int64) *BackendConnectionErrors
SetTimeoutCount sets the TimeoutCount field's value.
func (*BackendConnectionErrors) SetUnknownHostCount ¶
func (s *BackendConnectionErrors) SetUnknownHostCount(v int64) *BackendConnectionErrors
SetUnknownHostCount sets the UnknownHostCount field's value.
func (BackendConnectionErrors) String ¶
func (s BackendConnectionErrors) String() string
String returns the string representation
type BatchGetTracesInput ¶
type BatchGetTracesInput struct { // Pagination token. Not used. NextToken *string `type:"string"` // Specify the trace IDs of requests for which to retrieve segments. // // TraceIds is a required field TraceIds []*string `type:"list" required:"true"` // contains filtered or unexported fields }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/BatchGetTracesRequest
func (BatchGetTracesInput) GoString ¶
func (s BatchGetTracesInput) GoString() string
GoString returns the string representation
func (*BatchGetTracesInput) SetNextToken ¶
func (s *BatchGetTracesInput) SetNextToken(v string) *BatchGetTracesInput
SetNextToken sets the NextToken field's value.
func (*BatchGetTracesInput) SetTraceIds ¶
func (s *BatchGetTracesInput) SetTraceIds(v []*string) *BatchGetTracesInput
SetTraceIds sets the TraceIds field's value.
func (BatchGetTracesInput) String ¶
func (s BatchGetTracesInput) String() string
String returns the string representation
func (*BatchGetTracesInput) Validate ¶
func (s *BatchGetTracesInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type BatchGetTracesOutput ¶
type BatchGetTracesOutput struct { // Pagination token. Not used. NextToken *string `type:"string"` // Full traces for the specified requests. Traces []*Trace `type:"list"` // Trace IDs of requests that haven't been processed. UnprocessedTraceIds []*string `type:"list"` // contains filtered or unexported fields }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/BatchGetTracesResult
func (BatchGetTracesOutput) GoString ¶
func (s BatchGetTracesOutput) GoString() string
GoString returns the string representation
func (*BatchGetTracesOutput) SetNextToken ¶
func (s *BatchGetTracesOutput) SetNextToken(v string) *BatchGetTracesOutput
SetNextToken sets the NextToken field's value.
func (*BatchGetTracesOutput) SetTraces ¶
func (s *BatchGetTracesOutput) SetTraces(v []*Trace) *BatchGetTracesOutput
SetTraces sets the Traces field's value.
func (*BatchGetTracesOutput) SetUnprocessedTraceIds ¶
func (s *BatchGetTracesOutput) SetUnprocessedTraceIds(v []*string) *BatchGetTracesOutput
SetUnprocessedTraceIds sets the UnprocessedTraceIds field's value.
func (BatchGetTracesOutput) String ¶
func (s BatchGetTracesOutput) String() string
String returns the string representation
type Edge ¶
type Edge struct { // Aliases for the edge. Aliases []*Alias `type:"list"` // The end time of the last segment on the edge. EndTime *time.Time `type:"timestamp" timestampFormat:"unix"` // Identifier of the edge. Unique within a service map. ReferenceId *int64 `type:"integer"` // Histogram describing the prominence of response times on the edge. ResponseTimeHistogram []*HistogramEntry `type:"list"` // The start time of the first segment on the edge. StartTime *time.Time `type:"timestamp" timestampFormat:"unix"` // Response statistics for segments on the edge. SummaryStatistics *EdgeStatistics `type:"structure"` // contains filtered or unexported fields }
Information about a connection between two services. Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/Edge
func (*Edge) SetAliases ¶
SetAliases sets the Aliases field's value.
func (*Edge) SetEndTime ¶
SetEndTime sets the EndTime field's value.
func (*Edge) SetReferenceId ¶
SetReferenceId sets the ReferenceId field's value.
func (*Edge) SetResponseTimeHistogram ¶
func (s *Edge) SetResponseTimeHistogram(v []*HistogramEntry) *Edge
SetResponseTimeHistogram sets the ResponseTimeHistogram field's value.
func (*Edge) SetStartTime ¶
SetStartTime sets the StartTime field's value.
func (*Edge) SetSummaryStatistics ¶
func (s *Edge) SetSummaryStatistics(v *EdgeStatistics) *Edge
SetSummaryStatistics sets the SummaryStatistics field's value.
type EdgeStatistics ¶
type EdgeStatistics struct { // Information about requests that failed with a 4xx Client Error status code. ErrorStatistics *ErrorStatistics `type:"structure"` // Information about requests that failed with a 5xx Server Error status code. FaultStatistics *FaultStatistics `type:"structure"` // The number of requests that completed with a 2xx Success status code. OkCount *int64 `type:"long"` // The total number of completed requests. TotalCount *int64 `type:"long"` // The aggregate response time of completed requests. TotalResponseTime *float64 `type:"double"` // contains filtered or unexported fields }
Response statistics for an edge. Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/EdgeStatistics
func (EdgeStatistics) GoString ¶
func (s EdgeStatistics) GoString() string
GoString returns the string representation
func (*EdgeStatistics) SetErrorStatistics ¶
func (s *EdgeStatistics) SetErrorStatistics(v *ErrorStatistics) *EdgeStatistics
SetErrorStatistics sets the ErrorStatistics field's value.
func (*EdgeStatistics) SetFaultStatistics ¶
func (s *EdgeStatistics) SetFaultStatistics(v *FaultStatistics) *EdgeStatistics
SetFaultStatistics sets the FaultStatistics field's value.
func (*EdgeStatistics) SetOkCount ¶
func (s *EdgeStatistics) SetOkCount(v int64) *EdgeStatistics
SetOkCount sets the OkCount field's value.
func (*EdgeStatistics) SetTotalCount ¶
func (s *EdgeStatistics) SetTotalCount(v int64) *EdgeStatistics
SetTotalCount sets the TotalCount field's value.
func (*EdgeStatistics) SetTotalResponseTime ¶
func (s *EdgeStatistics) SetTotalResponseTime(v float64) *EdgeStatistics
SetTotalResponseTime sets the TotalResponseTime field's value.
func (EdgeStatistics) String ¶
func (s EdgeStatistics) String() string
String returns the string representation
type ErrorStatistics ¶
type ErrorStatistics struct { // The number of requests that failed with untracked 4xx Client Error status // codes. OtherCount *int64 `type:"long"` // The number of requests that failed with a 419 throttling status code. ThrottleCount *int64 `type:"long"` // The total number of requests that failed with a 4xx Client Error status code. TotalCount *int64 `type:"long"` // contains filtered or unexported fields }
Information about requests that failed with a 4xx Client Error status code. Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/ErrorStatistics
func (ErrorStatistics) GoString ¶
func (s ErrorStatistics) GoString() string
GoString returns the string representation
func (*ErrorStatistics) SetOtherCount ¶
func (s *ErrorStatistics) SetOtherCount(v int64) *ErrorStatistics
SetOtherCount sets the OtherCount field's value.
func (*ErrorStatistics) SetThrottleCount ¶
func (s *ErrorStatistics) SetThrottleCount(v int64) *ErrorStatistics
SetThrottleCount sets the ThrottleCount field's value.
func (*ErrorStatistics) SetTotalCount ¶
func (s *ErrorStatistics) SetTotalCount(v int64) *ErrorStatistics
SetTotalCount sets the TotalCount field's value.
func (ErrorStatistics) String ¶
func (s ErrorStatistics) String() string
String returns the string representation
type FaultStatistics ¶
type FaultStatistics struct { // The number of requests that failed with untracked 5xx Server Error status // codes. OtherCount *int64 `type:"long"` // The total number of requests that failed with a 5xx Server Error status code. TotalCount *int64 `type:"long"` // contains filtered or unexported fields }
Information about requests that failed with a 5xx Server Error status code. Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/FaultStatistics
func (FaultStatistics) GoString ¶
func (s FaultStatistics) GoString() string
GoString returns the string representation
func (*FaultStatistics) SetOtherCount ¶
func (s *FaultStatistics) SetOtherCount(v int64) *FaultStatistics
SetOtherCount sets the OtherCount field's value.
func (*FaultStatistics) SetTotalCount ¶
func (s *FaultStatistics) SetTotalCount(v int64) *FaultStatistics
SetTotalCount sets the TotalCount field's value.
func (FaultStatistics) String ¶
func (s FaultStatistics) String() string
String returns the string representation
type GetServiceGraphInput ¶
type GetServiceGraphInput struct { // The end of the time frame for which to generate a graph. // // EndTime is a required field EndTime *time.Time `type:"timestamp" timestampFormat:"unix" required:"true"` // Pagination token. Not used. NextToken *string `type:"string"` // The start of the time frame for which to generate a graph. // // StartTime is a required field StartTime *time.Time `type:"timestamp" timestampFormat:"unix" required:"true"` // contains filtered or unexported fields }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetServiceGraphRequest
func (GetServiceGraphInput) GoString ¶
func (s GetServiceGraphInput) GoString() string
GoString returns the string representation
func (*GetServiceGraphInput) SetEndTime ¶
func (s *GetServiceGraphInput) SetEndTime(v time.Time) *GetServiceGraphInput
SetEndTime sets the EndTime field's value.
func (*GetServiceGraphInput) SetNextToken ¶
func (s *GetServiceGraphInput) SetNextToken(v string) *GetServiceGraphInput
SetNextToken sets the NextToken field's value.
func (*GetServiceGraphInput) SetStartTime ¶
func (s *GetServiceGraphInput) SetStartTime(v time.Time) *GetServiceGraphInput
SetStartTime sets the StartTime field's value.
func (GetServiceGraphInput) String ¶
func (s GetServiceGraphInput) String() string
String returns the string representation
func (*GetServiceGraphInput) Validate ¶
func (s *GetServiceGraphInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetServiceGraphOutput ¶
type GetServiceGraphOutput struct { // The end of the time frame for which the graph was generated. EndTime *time.Time `type:"timestamp" timestampFormat:"unix"` // Pagination token. Not used. NextToken *string `type:"string"` // The services that have processed a traced request during the specified time // frame. Services []*Service `type:"list"` // The start of the time frame for which the graph was generated. StartTime *time.Time `type:"timestamp" timestampFormat:"unix"` // contains filtered or unexported fields }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetServiceGraphResult
func (GetServiceGraphOutput) GoString ¶
func (s GetServiceGraphOutput) GoString() string
GoString returns the string representation
func (*GetServiceGraphOutput) SetEndTime ¶
func (s *GetServiceGraphOutput) SetEndTime(v time.Time) *GetServiceGraphOutput
SetEndTime sets the EndTime field's value.
func (*GetServiceGraphOutput) SetNextToken ¶
func (s *GetServiceGraphOutput) SetNextToken(v string) *GetServiceGraphOutput
SetNextToken sets the NextToken field's value.
func (*GetServiceGraphOutput) SetServices ¶
func (s *GetServiceGraphOutput) SetServices(v []*Service) *GetServiceGraphOutput
SetServices sets the Services field's value.
func (*GetServiceGraphOutput) SetStartTime ¶
func (s *GetServiceGraphOutput) SetStartTime(v time.Time) *GetServiceGraphOutput
SetStartTime sets the StartTime field's value.
func (GetServiceGraphOutput) String ¶
func (s GetServiceGraphOutput) String() string
String returns the string representation
type GetTraceGraphInput ¶
type GetTraceGraphInput struct { // Pagination token. Not used. NextToken *string `type:"string"` // Trace IDs of requests for which to generate a service graph. // // TraceIds is a required field TraceIds []*string `type:"list" required:"true"` // contains filtered or unexported fields }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetTraceGraphRequest
func (GetTraceGraphInput) GoString ¶
func (s GetTraceGraphInput) GoString() string
GoString returns the string representation
func (*GetTraceGraphInput) SetNextToken ¶
func (s *GetTraceGraphInput) SetNextToken(v string) *GetTraceGraphInput
SetNextToken sets the NextToken field's value.
func (*GetTraceGraphInput) SetTraceIds ¶
func (s *GetTraceGraphInput) SetTraceIds(v []*string) *GetTraceGraphInput
SetTraceIds sets the TraceIds field's value.
func (GetTraceGraphInput) String ¶
func (s GetTraceGraphInput) String() string
String returns the string representation
func (*GetTraceGraphInput) Validate ¶
func (s *GetTraceGraphInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetTraceGraphOutput ¶
type GetTraceGraphOutput struct { // Pagination token. Not used. NextToken *string `type:"string"` // The services that have processed one of the specified requests. Services []*Service `type:"list"` // contains filtered or unexported fields }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetTraceGraphResult
func (GetTraceGraphOutput) GoString ¶
func (s GetTraceGraphOutput) GoString() string
GoString returns the string representation
func (*GetTraceGraphOutput) SetNextToken ¶
func (s *GetTraceGraphOutput) SetNextToken(v string) *GetTraceGraphOutput
SetNextToken sets the NextToken field's value.
func (*GetTraceGraphOutput) SetServices ¶
func (s *GetTraceGraphOutput) SetServices(v []*Service) *GetTraceGraphOutput
SetServices sets the Services field's value.
func (GetTraceGraphOutput) String ¶
func (s GetTraceGraphOutput) String() string
String returns the string representation
type GetTraceSummariesInput ¶
type GetTraceSummariesInput struct { // The end of the time frame for which to retrieve traces. // // EndTime is a required field EndTime *time.Time `type:"timestamp" timestampFormat:"unix" required:"true"` // Specify a filter expression to retrieve trace summaries for services or requests // that meet certain requirements. FilterExpression *string `type:"string"` // Specify the pagination token returned by a previous request to retrieve the // next page of results. NextToken *string `type:"string"` // Set to true to get summaries for only a subset of available traces. Sampling *bool `type:"boolean"` // The start of the time frame for which to retrieve traces. // // StartTime is a required field StartTime *time.Time `type:"timestamp" timestampFormat:"unix" required:"true"` // contains filtered or unexported fields }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetTraceSummariesRequest
func (GetTraceSummariesInput) GoString ¶
func (s GetTraceSummariesInput) GoString() string
GoString returns the string representation
func (*GetTraceSummariesInput) SetEndTime ¶
func (s *GetTraceSummariesInput) SetEndTime(v time.Time) *GetTraceSummariesInput
SetEndTime sets the EndTime field's value.
func (*GetTraceSummariesInput) SetFilterExpression ¶
func (s *GetTraceSummariesInput) SetFilterExpression(v string) *GetTraceSummariesInput
SetFilterExpression sets the FilterExpression field's value.
func (*GetTraceSummariesInput) SetNextToken ¶
func (s *GetTraceSummariesInput) SetNextToken(v string) *GetTraceSummariesInput
SetNextToken sets the NextToken field's value.
func (*GetTraceSummariesInput) SetSampling ¶
func (s *GetTraceSummariesInput) SetSampling(v bool) *GetTraceSummariesInput
SetSampling sets the Sampling field's value.
func (*GetTraceSummariesInput) SetStartTime ¶
func (s *GetTraceSummariesInput) SetStartTime(v time.Time) *GetTraceSummariesInput
SetStartTime sets the StartTime field's value.
func (GetTraceSummariesInput) String ¶
func (s GetTraceSummariesInput) String() string
String returns the string representation
func (*GetTraceSummariesInput) Validate ¶
func (s *GetTraceSummariesInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetTraceSummariesOutput ¶
type GetTraceSummariesOutput struct { // The start time of this page of results. ApproximateTime *time.Time `type:"timestamp" timestampFormat:"unix"` // If the requested time frame contained more than one page of results, you // can use this token to retrieve the next page. The first page contains the // most most recent results, closest to the end of the time frame. NextToken *string `type:"string"` // Trace IDs and metadata for traces that were found in the specified time frame. TraceSummaries []*TraceSummary `type:"list"` // The number of traces that were processed to get this set of summaries. TracesProcessedCount *int64 `type:"long"` // contains filtered or unexported fields }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetTraceSummariesResult
func (GetTraceSummariesOutput) GoString ¶
func (s GetTraceSummariesOutput) GoString() string
GoString returns the string representation
func (*GetTraceSummariesOutput) SetApproximateTime ¶
func (s *GetTraceSummariesOutput) SetApproximateTime(v time.Time) *GetTraceSummariesOutput
SetApproximateTime sets the ApproximateTime field's value.
func (*GetTraceSummariesOutput) SetNextToken ¶
func (s *GetTraceSummariesOutput) SetNextToken(v string) *GetTraceSummariesOutput
SetNextToken sets the NextToken field's value.
func (*GetTraceSummariesOutput) SetTraceSummaries ¶
func (s *GetTraceSummariesOutput) SetTraceSummaries(v []*TraceSummary) *GetTraceSummariesOutput
SetTraceSummaries sets the TraceSummaries field's value.
func (*GetTraceSummariesOutput) SetTracesProcessedCount ¶
func (s *GetTraceSummariesOutput) SetTracesProcessedCount(v int64) *GetTraceSummariesOutput
SetTracesProcessedCount sets the TracesProcessedCount field's value.
func (GetTraceSummariesOutput) String ¶
func (s GetTraceSummariesOutput) String() string
String returns the string representation
type HistogramEntry ¶
type HistogramEntry struct { // The prevalence of the entry. Count *int64 `type:"integer"` // The value of the entry. Value *float64 `type:"double"` // contains filtered or unexported fields }
An entry in a histogram for a statistic. A histogram maps the range of observed values on the X axis, and the prevalence of each value on the Y axis. Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/HistogramEntry
func (HistogramEntry) GoString ¶
func (s HistogramEntry) GoString() string
GoString returns the string representation
func (*HistogramEntry) SetCount ¶
func (s *HistogramEntry) SetCount(v int64) *HistogramEntry
SetCount sets the Count field's value.
func (*HistogramEntry) SetValue ¶
func (s *HistogramEntry) SetValue(v float64) *HistogramEntry
SetValue sets the Value field's value.
func (HistogramEntry) String ¶
func (s HistogramEntry) String() string
String returns the string representation
type Http ¶
type Http struct { // The IP address of the requestor. ClientIp *string `type:"string"` // The request method. HttpMethod *string `type:"string"` // The response status. HttpStatus *int64 `type:"integer"` // The request URL. HttpURL *string `type:"string"` // The request's user agent string. UserAgent *string `type:"string"` // contains filtered or unexported fields }
Information about an HTTP request. Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/Http
func (*Http) SetClientIp ¶
SetClientIp sets the ClientIp field's value.
func (*Http) SetHttpMethod ¶
SetHttpMethod sets the HttpMethod field's value.
func (*Http) SetHttpStatus ¶
SetHttpStatus sets the HttpStatus field's value.
func (*Http) SetHttpURL ¶
SetHttpURL sets the HttpURL field's value.
func (*Http) SetUserAgent ¶
SetUserAgent sets the UserAgent field's value.
type PutTelemetryRecordsInput ¶
type PutTelemetryRecordsInput struct { EC2InstanceId *string `type:"string"` Hostname *string `type:"string"` ResourceARN *string `type:"string"` // TelemetryRecords is a required field TelemetryRecords []*TelemetryRecord `type:"list" required:"true"` // contains filtered or unexported fields }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/PutTelemetryRecordsRequest
func (PutTelemetryRecordsInput) GoString ¶
func (s PutTelemetryRecordsInput) GoString() string
GoString returns the string representation
func (*PutTelemetryRecordsInput) SetEC2InstanceId ¶
func (s *PutTelemetryRecordsInput) SetEC2InstanceId(v string) *PutTelemetryRecordsInput
SetEC2InstanceId sets the EC2InstanceId field's value.
func (*PutTelemetryRecordsInput) SetHostname ¶
func (s *PutTelemetryRecordsInput) SetHostname(v string) *PutTelemetryRecordsInput
SetHostname sets the Hostname field's value.
func (*PutTelemetryRecordsInput) SetResourceARN ¶
func (s *PutTelemetryRecordsInput) SetResourceARN(v string) *PutTelemetryRecordsInput
SetResourceARN sets the ResourceARN field's value.
func (*PutTelemetryRecordsInput) SetTelemetryRecords ¶
func (s *PutTelemetryRecordsInput) SetTelemetryRecords(v []*TelemetryRecord) *PutTelemetryRecordsInput
SetTelemetryRecords sets the TelemetryRecords field's value.
func (PutTelemetryRecordsInput) String ¶
func (s PutTelemetryRecordsInput) String() string
String returns the string representation
func (*PutTelemetryRecordsInput) Validate ¶
func (s *PutTelemetryRecordsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type PutTelemetryRecordsOutput ¶
type PutTelemetryRecordsOutput struct {
// contains filtered or unexported fields
}
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/PutTelemetryRecordsResult
func (PutTelemetryRecordsOutput) GoString ¶
func (s PutTelemetryRecordsOutput) GoString() string
GoString returns the string representation
func (PutTelemetryRecordsOutput) String ¶
func (s PutTelemetryRecordsOutput) String() string
String returns the string representation
type PutTraceSegmentsInput ¶
type PutTraceSegmentsInput struct { // A JSON document defining one or more segments or subsegments. Segments must // include the following fields. // // Required Segment Document Fields // // * name - The name of the service that handled the request. // // * id - A 64-bit identifier for the segment, unique among segments in the // same trace, in 16 hexadecimal digits. // // * trace_id - A unique identifier that connects all segments and subsegments // originating from a single client request. // // * start_time - Time the segment or subsegment was created, in floating // point seconds in epoch time, accurate to milliseconds. For example, 1480615200.010 // or 1.480615200010E9. // // * end_time - Time the segment or subsegment was closed. For example, 1480615200.090 // or 1.480615200090E9. Specify either an end_time or in_progress. // // * in_progress - Set to true instead of specifying an end_time to record // that a segment has been started, but is not complete. Send an in progress // segment when your application receives a request that will take a long // time to serve, to trace the fact that the request was received. When the // response is sent, send the complete segment to overwrite the in-progress // segment. // // A trace_id consists of three numbers separated by hyphens. For example, 1-58406520-a006649127e371903a2de979. // This includes: // // Trace ID Format // // * The version number, i.e. 1. // // * The time of the original request, in Unix epoch time, in 8 hexadecimal // digits. For example, 10:00AM December 2nd, 2016 PST in epoch time is 1480615200 // seconds, or 58406520 in hexadecimal. // // * A 96-bit identifier for the trace, globally unique, in 24 hexadecimal // digits. // // TraceSegmentDocuments is a required field TraceSegmentDocuments []*string `type:"list" required:"true"` // contains filtered or unexported fields }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/PutTraceSegmentsRequest
func (PutTraceSegmentsInput) GoString ¶
func (s PutTraceSegmentsInput) GoString() string
GoString returns the string representation
func (*PutTraceSegmentsInput) SetTraceSegmentDocuments ¶
func (s *PutTraceSegmentsInput) SetTraceSegmentDocuments(v []*string) *PutTraceSegmentsInput
SetTraceSegmentDocuments sets the TraceSegmentDocuments field's value.
func (PutTraceSegmentsInput) String ¶
func (s PutTraceSegmentsInput) String() string
String returns the string representation
func (*PutTraceSegmentsInput) Validate ¶
func (s *PutTraceSegmentsInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type PutTraceSegmentsOutput ¶
type PutTraceSegmentsOutput struct { // Segments that failed processing. UnprocessedTraceSegments []*UnprocessedTraceSegment `type:"list"` // contains filtered or unexported fields }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/PutTraceSegmentsResult
func (PutTraceSegmentsOutput) GoString ¶
func (s PutTraceSegmentsOutput) GoString() string
GoString returns the string representation
func (*PutTraceSegmentsOutput) SetUnprocessedTraceSegments ¶
func (s *PutTraceSegmentsOutput) SetUnprocessedTraceSegments(v []*UnprocessedTraceSegment) *PutTraceSegmentsOutput
SetUnprocessedTraceSegments sets the UnprocessedTraceSegments field's value.
func (PutTraceSegmentsOutput) String ¶
func (s PutTraceSegmentsOutput) String() string
String returns the string representation
type Segment ¶
type Segment struct { // The segment document. Document *string `min:"1" type:"string"` // The segment's ID. Id *string `min:"16" type:"string"` // contains filtered or unexported fields }
Information about a segment Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/Segment
func (*Segment) SetDocument ¶
SetDocument sets the Document field's value.
type Service ¶
type Service struct { // Identifier of the AWS account in which the service runs. AccountId *string `type:"string"` // Histogram mapping the spread of trace durations DurationHistogram []*HistogramEntry `type:"list"` // Connections to downstream services. Edges []*Edge `type:"list"` // The end time of the last segment that the service generated. EndTime *time.Time `type:"timestamp" timestampFormat:"unix"` // The canonical name of the service. Name *string `type:"string"` // A list of names for the service, including the canonical name. Names []*string `type:"list"` // Identifier for the service. Unique within the service map. ReferenceId *int64 `type:"integer"` // Indicates that the service was the first service to process a request. Root *bool `type:"boolean"` // The start time of the first segment that the service generated. StartTime *time.Time `type:"timestamp" timestampFormat:"unix"` // The service's state. State *string `type:"string"` // Aggregated statistics for the service. SummaryStatistics *ServiceStatistics `type:"structure"` // The type of service. // // * AWS Resource - The type of an AWS resource. For example, AWS::EC2::Instance // for a application running on Amazon EC2 or AWS::DynamoDB::Table for an // Amazon DynamoDB table that the application used. // // * AWS Service - The type of an AWS service. For example, AWS::DynamoDB // for downstream calls to Amazon DynamoDB that didn't target a specific // table. // // * client - Represents the clients that sent requests to a root service. // // * remote - A downstream service of indeterminate type. Type *string `type:"string"` // contains filtered or unexported fields }
Information about an application that processed requests, users that made requests, or downstream services, resources and applications that an application used. Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/Service
func (*Service) SetAccountId ¶
SetAccountId sets the AccountId field's value.
func (*Service) SetDurationHistogram ¶
func (s *Service) SetDurationHistogram(v []*HistogramEntry) *Service
SetDurationHistogram sets the DurationHistogram field's value.
func (*Service) SetEndTime ¶
SetEndTime sets the EndTime field's value.
func (*Service) SetReferenceId ¶
SetReferenceId sets the ReferenceId field's value.
func (*Service) SetStartTime ¶
SetStartTime sets the StartTime field's value.
func (*Service) SetSummaryStatistics ¶
func (s *Service) SetSummaryStatistics(v *ServiceStatistics) *Service
SetSummaryStatistics sets the SummaryStatistics field's value.
type ServiceId ¶
type ServiceId struct { AccountId *string `type:"string"` Name *string `type:"string"` Names []*string `type:"list"` Type *string `type:"string"` // contains filtered or unexported fields }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/ServiceId
func (*ServiceId) SetAccountId ¶
SetAccountId sets the AccountId field's value.
type ServiceStatistics ¶
type ServiceStatistics struct { // Information about requests that failed with a 4xx Client Error status code. ErrorStatistics *ErrorStatistics `type:"structure"` // Information about requests that failed with a 5xx Server Error status code. FaultStatistics *FaultStatistics `type:"structure"` // The number of requests that completed with a 2xx Success status code. OkCount *int64 `type:"long"` // The total number of completed requests. TotalCount *int64 `type:"long"` // The aggregate response time of completed requests. TotalResponseTime *float64 `type:"double"` // contains filtered or unexported fields }
Response statistics for a service. Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/ServiceStatistics
func (ServiceStatistics) GoString ¶
func (s ServiceStatistics) GoString() string
GoString returns the string representation
func (*ServiceStatistics) SetErrorStatistics ¶
func (s *ServiceStatistics) SetErrorStatistics(v *ErrorStatistics) *ServiceStatistics
SetErrorStatistics sets the ErrorStatistics field's value.
func (*ServiceStatistics) SetFaultStatistics ¶
func (s *ServiceStatistics) SetFaultStatistics(v *FaultStatistics) *ServiceStatistics
SetFaultStatistics sets the FaultStatistics field's value.
func (*ServiceStatistics) SetOkCount ¶
func (s *ServiceStatistics) SetOkCount(v int64) *ServiceStatistics
SetOkCount sets the OkCount field's value.
func (*ServiceStatistics) SetTotalCount ¶
func (s *ServiceStatistics) SetTotalCount(v int64) *ServiceStatistics
SetTotalCount sets the TotalCount field's value.
func (*ServiceStatistics) SetTotalResponseTime ¶
func (s *ServiceStatistics) SetTotalResponseTime(v float64) *ServiceStatistics
SetTotalResponseTime sets the TotalResponseTime field's value.
func (ServiceStatistics) String ¶
func (s ServiceStatistics) String() string
String returns the string representation
type TelemetryRecord ¶
type TelemetryRecord struct { BackendConnectionErrors *BackendConnectionErrors `type:"structure"` SegmentsReceivedCount *int64 `type:"integer"` SegmentsRejectedCount *int64 `type:"integer"` SegmentsSentCount *int64 `type:"integer"` SegmentsSpilloverCount *int64 `type:"integer"` Timestamp *time.Time `type:"timestamp" timestampFormat:"unix"` // contains filtered or unexported fields }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/TelemetryRecord
func (TelemetryRecord) GoString ¶
func (s TelemetryRecord) GoString() string
GoString returns the string representation
func (*TelemetryRecord) SetBackendConnectionErrors ¶
func (s *TelemetryRecord) SetBackendConnectionErrors(v *BackendConnectionErrors) *TelemetryRecord
SetBackendConnectionErrors sets the BackendConnectionErrors field's value.
func (*TelemetryRecord) SetSegmentsReceivedCount ¶
func (s *TelemetryRecord) SetSegmentsReceivedCount(v int64) *TelemetryRecord
SetSegmentsReceivedCount sets the SegmentsReceivedCount field's value.
func (*TelemetryRecord) SetSegmentsRejectedCount ¶
func (s *TelemetryRecord) SetSegmentsRejectedCount(v int64) *TelemetryRecord
SetSegmentsRejectedCount sets the SegmentsRejectedCount field's value.
func (*TelemetryRecord) SetSegmentsSentCount ¶
func (s *TelemetryRecord) SetSegmentsSentCount(v int64) *TelemetryRecord
SetSegmentsSentCount sets the SegmentsSentCount field's value.
func (*TelemetryRecord) SetSegmentsSpilloverCount ¶
func (s *TelemetryRecord) SetSegmentsSpilloverCount(v int64) *TelemetryRecord
SetSegmentsSpilloverCount sets the SegmentsSpilloverCount field's value.
func (*TelemetryRecord) SetTimestamp ¶
func (s *TelemetryRecord) SetTimestamp(v time.Time) *TelemetryRecord
SetTimestamp sets the Timestamp field's value.
func (TelemetryRecord) String ¶
func (s TelemetryRecord) String() string
String returns the string representation
type Trace ¶
type Trace struct { // The length of time in seconds between the start time of the root segment // and the end time of the last segment that completed. Duration *float64 `type:"double"` // The unique identifier for the request that generated the trace's segments // and subsegments. Id *string `min:"35" type:"string"` // Segment documents for the segments and subsegments that comprise the trace. Segments []*Segment `type:"list"` // contains filtered or unexported fields }
A collection of segment documents with matching trace IDs. Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/Trace
func (*Trace) SetDuration ¶
SetDuration sets the Duration field's value.
func (*Trace) SetSegments ¶
SetSegments sets the Segments field's value.
type TraceSummary ¶
type TraceSummary struct { // Annotations from the trace's segment documents. Annotations map[string][]*ValueWithServiceIds `type:"map"` // The length of time in seconds between the start time of the root segment // and the end time of the last segment that completed. Duration *float64 `type:"double"` // One or more of the segment documents has a 400 series error. HasError *bool `type:"boolean"` // One or more of the segment documents has a 500 series error. HasFault *bool `type:"boolean"` // One or more of the segment documents has a 429 throttling error. HasThrottle *bool `type:"boolean"` // Information about the HTTP request served by the trace. Http *Http `type:"structure"` // The unique identifier for the request that generated the trace's segments // and subsegments. Id *string `min:"35" type:"string"` // One or more of the segment documents is in progress. IsPartial *bool `type:"boolean"` // The length of time in seconds between the start and end times of the root // segment. If the service performs work asynchronously, the response time measures // the time before the response is sent to the user, while the duration measures // the amount of time before the last traced activity completes. ResponseTime *float64 `type:"double"` // Service IDs from the trace's segment documents. ServiceIds []*ServiceId `type:"list"` // Users from the trace's segment documents. Users []*TraceUser `type:"list"` // contains filtered or unexported fields }
Metadata generated from the segment documents in a trace. Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/TraceSummary
func (TraceSummary) GoString ¶
func (s TraceSummary) GoString() string
GoString returns the string representation
func (*TraceSummary) SetAnnotations ¶
func (s *TraceSummary) SetAnnotations(v map[string][]*ValueWithServiceIds) *TraceSummary
SetAnnotations sets the Annotations field's value.
func (*TraceSummary) SetDuration ¶
func (s *TraceSummary) SetDuration(v float64) *TraceSummary
SetDuration sets the Duration field's value.
func (*TraceSummary) SetHasError ¶
func (s *TraceSummary) SetHasError(v bool) *TraceSummary
SetHasError sets the HasError field's value.
func (*TraceSummary) SetHasFault ¶
func (s *TraceSummary) SetHasFault(v bool) *TraceSummary
SetHasFault sets the HasFault field's value.
func (*TraceSummary) SetHasThrottle ¶
func (s *TraceSummary) SetHasThrottle(v bool) *TraceSummary
SetHasThrottle sets the HasThrottle field's value.
func (*TraceSummary) SetHttp ¶
func (s *TraceSummary) SetHttp(v *Http) *TraceSummary
SetHttp sets the Http field's value.
func (*TraceSummary) SetId ¶
func (s *TraceSummary) SetId(v string) *TraceSummary
SetId sets the Id field's value.
func (*TraceSummary) SetIsPartial ¶
func (s *TraceSummary) SetIsPartial(v bool) *TraceSummary
SetIsPartial sets the IsPartial field's value.
func (*TraceSummary) SetResponseTime ¶
func (s *TraceSummary) SetResponseTime(v float64) *TraceSummary
SetResponseTime sets the ResponseTime field's value.
func (*TraceSummary) SetServiceIds ¶
func (s *TraceSummary) SetServiceIds(v []*ServiceId) *TraceSummary
SetServiceIds sets the ServiceIds field's value.
func (*TraceSummary) SetUsers ¶
func (s *TraceSummary) SetUsers(v []*TraceUser) *TraceSummary
SetUsers sets the Users field's value.
func (TraceSummary) String ¶
func (s TraceSummary) String() string
String returns the string representation
type TraceUser ¶
type TraceUser struct { // Services that the user's request hit. ServiceIds []*ServiceId `type:"list"` // The user's name. UserName *string `type:"string"` // contains filtered or unexported fields }
Information about a user recorded in segment documents. Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/TraceUser
func (*TraceUser) SetServiceIds ¶
SetServiceIds sets the ServiceIds field's value.
func (*TraceUser) SetUserName ¶
SetUserName sets the UserName field's value.
type UnprocessedTraceSegment ¶
type UnprocessedTraceSegment struct { // The error that caused processing to fail. ErrorCode *string `type:"string"` // The segment's ID. Id *string `type:"string"` // The error message. Message *string `type:"string"` // contains filtered or unexported fields }
Information about a segment that failed processing. Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/UnprocessedTraceSegment
func (UnprocessedTraceSegment) GoString ¶
func (s UnprocessedTraceSegment) GoString() string
GoString returns the string representation
func (*UnprocessedTraceSegment) SetErrorCode ¶
func (s *UnprocessedTraceSegment) SetErrorCode(v string) *UnprocessedTraceSegment
SetErrorCode sets the ErrorCode field's value.
func (*UnprocessedTraceSegment) SetId ¶
func (s *UnprocessedTraceSegment) SetId(v string) *UnprocessedTraceSegment
SetId sets the Id field's value.
func (*UnprocessedTraceSegment) SetMessage ¶
func (s *UnprocessedTraceSegment) SetMessage(v string) *UnprocessedTraceSegment
SetMessage sets the Message field's value.
func (UnprocessedTraceSegment) String ¶
func (s UnprocessedTraceSegment) String() string
String returns the string representation
type ValueWithServiceIds ¶
type ValueWithServiceIds struct { // Values of the annotation. AnnotationValue *AnnotationValue `type:"structure"` // Services to which the annotation applies. ServiceIds []*ServiceId `type:"list"` // contains filtered or unexported fields }
Information about a segment annotation. Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/ValueWithServiceIds
func (ValueWithServiceIds) GoString ¶
func (s ValueWithServiceIds) GoString() string
GoString returns the string representation
func (*ValueWithServiceIds) SetAnnotationValue ¶
func (s *ValueWithServiceIds) SetAnnotationValue(v *AnnotationValue) *ValueWithServiceIds
SetAnnotationValue sets the AnnotationValue field's value.
func (*ValueWithServiceIds) SetServiceIds ¶
func (s *ValueWithServiceIds) SetServiceIds(v []*ServiceId) *ValueWithServiceIds
SetServiceIds sets the ServiceIds field's value.
func (ValueWithServiceIds) String ¶
func (s ValueWithServiceIds) String() string
String returns the string representation
type XRay ¶
AWS X-Ray provides APIs for managing debug traces and retrieving service maps and other data created by processing those traces. The service client's operations are safe to be used concurrently. It is not safe to mutate any of the client's properties though. Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12
func New ¶
func New(p client.ConfigProvider, cfgs ...*aws.Config) *XRay
New creates a new instance of the XRay client with a session. If additional configuration is needed for the client instance use the optional aws.Config parameter to add your extra config.
Example:
// Create a XRay client from just a session. svc := xray.New(mySession) // Create a XRay client with additional configuration svc := xray.New(mySession, aws.NewConfig().WithRegion("us-west-2"))
func (*XRay) BatchGetTraces ¶
func (c *XRay) BatchGetTraces(input *BatchGetTracesInput) (*BatchGetTracesOutput, error)
BatchGetTraces API operation for AWS X-Ray.
Retrieves a list of traces specified by ID. Each trace is a collection of segment documents that originates from a single request. Use GetTraceSummaries to get a list of trace IDs.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for AWS X-Ray's API operation BatchGetTraces for usage and error information.
Returned Error Codes:
ErrCodeInvalidRequestException "InvalidRequestException" The request is missing required parameters or has invalid parameters.
ErrCodeThrottledException "ThrottledException" The request exceeds the maximum number of requests per second.
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/BatchGetTraces
func (*XRay) BatchGetTracesRequest ¶
func (c *XRay) BatchGetTracesRequest(input *BatchGetTracesInput) (req *request.Request, output *BatchGetTracesOutput)
BatchGetTracesRequest generates a "aws/request.Request" representing the client's request for the BatchGetTraces operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See BatchGetTraces for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the BatchGetTraces method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the BatchGetTracesRequest method. req, resp := client.BatchGetTracesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/BatchGetTraces
func (*XRay) BatchGetTracesWithContext ¶ added in v1.8.0
func (c *XRay) BatchGetTracesWithContext(ctx aws.Context, input *BatchGetTracesInput, opts ...request.Option) (*BatchGetTracesOutput, error)
BatchGetTracesWithContext is the same as BatchGetTraces with the addition of the ability to pass a context and additional request options.
See BatchGetTraces for details on how to use this API operation.
The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.
func (*XRay) GetServiceGraph ¶
func (c *XRay) GetServiceGraph(input *GetServiceGraphInput) (*GetServiceGraphOutput, error)
GetServiceGraph API operation for AWS X-Ray.
Retrieves a document that describes services that process incoming requests, and downstream services that they call as a result. Root services process incoming requests and make calls to downstream services. Root services are applications that use the AWS X-Ray SDK. Downstream services can be other applications, AWS resources, HTTP web APIs, or SQL databases.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for AWS X-Ray's API operation GetServiceGraph for usage and error information.
Returned Error Codes:
ErrCodeInvalidRequestException "InvalidRequestException" The request is missing required parameters or has invalid parameters.
ErrCodeThrottledException "ThrottledException" The request exceeds the maximum number of requests per second.
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetServiceGraph
func (*XRay) GetServiceGraphRequest ¶
func (c *XRay) GetServiceGraphRequest(input *GetServiceGraphInput) (req *request.Request, output *GetServiceGraphOutput)
GetServiceGraphRequest generates a "aws/request.Request" representing the client's request for the GetServiceGraph operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See GetServiceGraph for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetServiceGraph method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the GetServiceGraphRequest method. req, resp := client.GetServiceGraphRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetServiceGraph
func (*XRay) GetServiceGraphWithContext ¶ added in v1.8.0
func (c *XRay) GetServiceGraphWithContext(ctx aws.Context, input *GetServiceGraphInput, opts ...request.Option) (*GetServiceGraphOutput, error)
GetServiceGraphWithContext is the same as GetServiceGraph with the addition of the ability to pass a context and additional request options.
See GetServiceGraph for details on how to use this API operation.
The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.
func (*XRay) GetTraceGraph ¶
func (c *XRay) GetTraceGraph(input *GetTraceGraphInput) (*GetTraceGraphOutput, error)
GetTraceGraph API operation for AWS X-Ray.
Retrieves a service graph for one or more specific trace IDs.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for AWS X-Ray's API operation GetTraceGraph for usage and error information.
Returned Error Codes:
ErrCodeInvalidRequestException "InvalidRequestException" The request is missing required parameters or has invalid parameters.
ErrCodeThrottledException "ThrottledException" The request exceeds the maximum number of requests per second.
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetTraceGraph
func (*XRay) GetTraceGraphRequest ¶
func (c *XRay) GetTraceGraphRequest(input *GetTraceGraphInput) (req *request.Request, output *GetTraceGraphOutput)
GetTraceGraphRequest generates a "aws/request.Request" representing the client's request for the GetTraceGraph operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See GetTraceGraph for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetTraceGraph method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the GetTraceGraphRequest method. req, resp := client.GetTraceGraphRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetTraceGraph
func (*XRay) GetTraceGraphWithContext ¶ added in v1.8.0
func (c *XRay) GetTraceGraphWithContext(ctx aws.Context, input *GetTraceGraphInput, opts ...request.Option) (*GetTraceGraphOutput, error)
GetTraceGraphWithContext is the same as GetTraceGraph with the addition of the ability to pass a context and additional request options.
See GetTraceGraph for details on how to use this API operation.
The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.
func (*XRay) GetTraceSummaries ¶
func (c *XRay) GetTraceSummaries(input *GetTraceSummariesInput) (*GetTraceSummariesOutput, error)
GetTraceSummaries API operation for AWS X-Ray.
Retrieves IDs and metadata for traces available for a specified time frame using an optional filter. To get the full traces, pass the trace IDs to BatchGetTraces.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for AWS X-Ray's API operation GetTraceSummaries for usage and error information.
Returned Error Codes:
ErrCodeInvalidRequestException "InvalidRequestException" The request is missing required parameters or has invalid parameters.
ErrCodeThrottledException "ThrottledException" The request exceeds the maximum number of requests per second.
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetTraceSummaries
func (*XRay) GetTraceSummariesRequest ¶
func (c *XRay) GetTraceSummariesRequest(input *GetTraceSummariesInput) (req *request.Request, output *GetTraceSummariesOutput)
GetTraceSummariesRequest generates a "aws/request.Request" representing the client's request for the GetTraceSummaries operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See GetTraceSummaries for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetTraceSummaries method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the GetTraceSummariesRequest method. req, resp := client.GetTraceSummariesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/GetTraceSummaries
func (*XRay) GetTraceSummariesWithContext ¶ added in v1.8.0
func (c *XRay) GetTraceSummariesWithContext(ctx aws.Context, input *GetTraceSummariesInput, opts ...request.Option) (*GetTraceSummariesOutput, error)
GetTraceSummariesWithContext is the same as GetTraceSummaries with the addition of the ability to pass a context and additional request options.
See GetTraceSummaries for details on how to use this API operation.
The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.
func (*XRay) PutTelemetryRecords ¶
func (c *XRay) PutTelemetryRecords(input *PutTelemetryRecordsInput) (*PutTelemetryRecordsOutput, error)
PutTelemetryRecords API operation for AWS X-Ray.
Used by the AWS X-Ray daemon to upload telemetry.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for AWS X-Ray's API operation PutTelemetryRecords for usage and error information.
Returned Error Codes:
ErrCodeInvalidRequestException "InvalidRequestException" The request is missing required parameters or has invalid parameters.
ErrCodeThrottledException "ThrottledException" The request exceeds the maximum number of requests per second.
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/PutTelemetryRecords
func (*XRay) PutTelemetryRecordsRequest ¶
func (c *XRay) PutTelemetryRecordsRequest(input *PutTelemetryRecordsInput) (req *request.Request, output *PutTelemetryRecordsOutput)
PutTelemetryRecordsRequest generates a "aws/request.Request" representing the client's request for the PutTelemetryRecords operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See PutTelemetryRecords for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutTelemetryRecords method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the PutTelemetryRecordsRequest method. req, resp := client.PutTelemetryRecordsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/PutTelemetryRecords
func (*XRay) PutTelemetryRecordsWithContext ¶ added in v1.8.0
func (c *XRay) PutTelemetryRecordsWithContext(ctx aws.Context, input *PutTelemetryRecordsInput, opts ...request.Option) (*PutTelemetryRecordsOutput, error)
PutTelemetryRecordsWithContext is the same as PutTelemetryRecords with the addition of the ability to pass a context and additional request options.
See PutTelemetryRecords for details on how to use this API operation.
The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.
func (*XRay) PutTraceSegments ¶
func (c *XRay) PutTraceSegments(input *PutTraceSegmentsInput) (*PutTraceSegmentsOutput, error)
PutTraceSegments API operation for AWS X-Ray.
Uploads segment documents to AWS X-Ray. The X-Ray SDK generates segment documents and sends them to the X-Ray daemon, which uploads them in batches. A segment document can be a completed segment, an in-progress segment, or an array of subsegments.
Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.
See the AWS API reference guide for AWS X-Ray's API operation PutTraceSegments for usage and error information.
Returned Error Codes:
ErrCodeInvalidRequestException "InvalidRequestException" The request is missing required parameters or has invalid parameters.
ErrCodeThrottledException "ThrottledException" The request exceeds the maximum number of requests per second.
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/PutTraceSegments
func (*XRay) PutTraceSegmentsRequest ¶
func (c *XRay) PutTraceSegmentsRequest(input *PutTraceSegmentsInput) (req *request.Request, output *PutTraceSegmentsOutput)
PutTraceSegmentsRequest generates a "aws/request.Request" representing the client's request for the PutTraceSegments operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
See PutTraceSegments for usage and error information.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutTraceSegments method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the PutTraceSegmentsRequest method. req, resp := client.PutTraceSegmentsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
Please also see https://docs.aws.amazon.com/goto/WebAPI/xray-2016-04-12/PutTraceSegments
func (*XRay) PutTraceSegmentsWithContext ¶ added in v1.8.0
func (c *XRay) PutTraceSegmentsWithContext(ctx aws.Context, input *PutTraceSegmentsInput, opts ...request.Option) (*PutTraceSegmentsOutput, error)
PutTraceSegmentsWithContext is the same as PutTraceSegments with the addition of the ability to pass a context and additional request options.
See PutTraceSegments for details on how to use this API operation.
The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.