Documentation ¶
Overview ¶
Package cloudwatchlogs provides a client for Amazon CloudWatch Logs.
Index ¶
- type CloudWatchLogs
- func (c *CloudWatchLogs) CreateLogGroup(input *CreateLogGroupInput) (*CreateLogGroupOutput, error)
- func (c *CloudWatchLogs) CreateLogGroupRequest(input *CreateLogGroupInput) (req *aws.Request, output *CreateLogGroupOutput)
- func (c *CloudWatchLogs) CreateLogStream(input *CreateLogStreamInput) (*CreateLogStreamOutput, error)
- func (c *CloudWatchLogs) CreateLogStreamRequest(input *CreateLogStreamInput) (req *aws.Request, output *CreateLogStreamOutput)
- func (c *CloudWatchLogs) DeleteLogGroup(input *DeleteLogGroupInput) (*DeleteLogGroupOutput, error)
- func (c *CloudWatchLogs) DeleteLogGroupRequest(input *DeleteLogGroupInput) (req *aws.Request, output *DeleteLogGroupOutput)
- func (c *CloudWatchLogs) DeleteLogStream(input *DeleteLogStreamInput) (*DeleteLogStreamOutput, error)
- func (c *CloudWatchLogs) DeleteLogStreamRequest(input *DeleteLogStreamInput) (req *aws.Request, output *DeleteLogStreamOutput)
- func (c *CloudWatchLogs) DeleteMetricFilter(input *DeleteMetricFilterInput) (*DeleteMetricFilterOutput, error)
- func (c *CloudWatchLogs) DeleteMetricFilterRequest(input *DeleteMetricFilterInput) (req *aws.Request, output *DeleteMetricFilterOutput)
- func (c *CloudWatchLogs) DeleteRetentionPolicy(input *DeleteRetentionPolicyInput) (*DeleteRetentionPolicyOutput, error)
- func (c *CloudWatchLogs) DeleteRetentionPolicyRequest(input *DeleteRetentionPolicyInput) (req *aws.Request, output *DeleteRetentionPolicyOutput)
- func (c *CloudWatchLogs) DescribeLogGroups(input *DescribeLogGroupsInput) (*DescribeLogGroupsOutput, error)
- func (c *CloudWatchLogs) DescribeLogGroupsPages(input *DescribeLogGroupsInput, ...) error
- func (c *CloudWatchLogs) DescribeLogGroupsRequest(input *DescribeLogGroupsInput) (req *aws.Request, output *DescribeLogGroupsOutput)
- func (c *CloudWatchLogs) DescribeLogStreams(input *DescribeLogStreamsInput) (*DescribeLogStreamsOutput, error)
- func (c *CloudWatchLogs) DescribeLogStreamsPages(input *DescribeLogStreamsInput, ...) error
- func (c *CloudWatchLogs) DescribeLogStreamsRequest(input *DescribeLogStreamsInput) (req *aws.Request, output *DescribeLogStreamsOutput)
- func (c *CloudWatchLogs) DescribeMetricFilters(input *DescribeMetricFiltersInput) (*DescribeMetricFiltersOutput, error)
- func (c *CloudWatchLogs) DescribeMetricFiltersPages(input *DescribeMetricFiltersInput, ...) error
- func (c *CloudWatchLogs) DescribeMetricFiltersRequest(input *DescribeMetricFiltersInput) (req *aws.Request, output *DescribeMetricFiltersOutput)
- func (c *CloudWatchLogs) FilterLogEvents(input *FilterLogEventsInput) (*FilterLogEventsOutput, error)
- func (c *CloudWatchLogs) FilterLogEventsRequest(input *FilterLogEventsInput) (req *aws.Request, output *FilterLogEventsOutput)
- func (c *CloudWatchLogs) GetLogEvents(input *GetLogEventsInput) (*GetLogEventsOutput, error)
- func (c *CloudWatchLogs) GetLogEventsPages(input *GetLogEventsInput, ...) error
- func (c *CloudWatchLogs) GetLogEventsRequest(input *GetLogEventsInput) (req *aws.Request, output *GetLogEventsOutput)
- func (c *CloudWatchLogs) PutLogEvents(input *PutLogEventsInput) (*PutLogEventsOutput, error)
- func (c *CloudWatchLogs) PutLogEventsRequest(input *PutLogEventsInput) (req *aws.Request, output *PutLogEventsOutput)
- func (c *CloudWatchLogs) PutMetricFilter(input *PutMetricFilterInput) (*PutMetricFilterOutput, error)
- func (c *CloudWatchLogs) PutMetricFilterRequest(input *PutMetricFilterInput) (req *aws.Request, output *PutMetricFilterOutput)
- func (c *CloudWatchLogs) PutRetentionPolicy(input *PutRetentionPolicyInput) (*PutRetentionPolicyOutput, error)
- func (c *CloudWatchLogs) PutRetentionPolicyRequest(input *PutRetentionPolicyInput) (req *aws.Request, output *PutRetentionPolicyOutput)
- func (c *CloudWatchLogs) TestMetricFilter(input *TestMetricFilterInput) (*TestMetricFilterOutput, error)
- func (c *CloudWatchLogs) TestMetricFilterRequest(input *TestMetricFilterInput) (req *aws.Request, output *TestMetricFilterOutput)
- type CreateLogGroupInput
- type CreateLogGroupOutput
- type CreateLogStreamInput
- type CreateLogStreamOutput
- type DeleteLogGroupInput
- type DeleteLogGroupOutput
- type DeleteLogStreamInput
- type DeleteLogStreamOutput
- type DeleteMetricFilterInput
- type DeleteMetricFilterOutput
- type DeleteRetentionPolicyInput
- type DeleteRetentionPolicyOutput
- type DescribeLogGroupsInput
- type DescribeLogGroupsOutput
- type DescribeLogStreamsInput
- type DescribeLogStreamsOutput
- type DescribeMetricFiltersInput
- type DescribeMetricFiltersOutput
- type FilterLogEventsInput
- type FilterLogEventsOutput
- type FilteredLogEvent
- type GetLogEventsInput
- type GetLogEventsOutput
- type InputLogEvent
- type LogGroup
- type LogStream
- type MetricFilter
- type MetricFilterMatchRecord
- type MetricTransformation
- type OutputLogEvent
- type PutLogEventsInput
- type PutLogEventsOutput
- type PutMetricFilterInput
- type PutMetricFilterOutput
- type PutRetentionPolicyInput
- type PutRetentionPolicyOutput
- type RejectedLogEventsInfo
- type SearchedLogStream
- type TestMetricFilterInput
- type TestMetricFilterOutput
Examples ¶
- CloudWatchLogs.CreateLogGroup
- CloudWatchLogs.CreateLogStream
- CloudWatchLogs.DeleteLogGroup
- CloudWatchLogs.DeleteLogStream
- CloudWatchLogs.DeleteMetricFilter
- CloudWatchLogs.DeleteRetentionPolicy
- CloudWatchLogs.DescribeLogGroups
- CloudWatchLogs.DescribeLogStreams
- CloudWatchLogs.DescribeMetricFilters
- CloudWatchLogs.FilterLogEvents
- CloudWatchLogs.GetLogEvents
- CloudWatchLogs.PutLogEvents
- CloudWatchLogs.PutMetricFilter
- CloudWatchLogs.PutRetentionPolicy
- CloudWatchLogs.TestMetricFilter
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type CloudWatchLogs ¶
CloudWatchLogs is a client for Amazon CloudWatch Logs.
func (*CloudWatchLogs) CreateLogGroup ¶
func (c *CloudWatchLogs) CreateLogGroup(input *CreateLogGroupInput) (*CreateLogGroupOutput, error)
Creates a new log group with the specified name. The name of the log group must be unique within a region for an AWS account. You can create up to 500 log groups per account.
You must use the following guidelines when naming a log group: Log group
names can be between 1 and 512 characters long. Allowed characters are a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), '/' (forward slash), and '.' (period).
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/awsutil" "github.com/aws/aws-sdk-go/service/cloudwatchlogs" ) func main() { svc := cloudwatchlogs.New(nil) params := &cloudwatchlogs.CreateLogGroupInput{ LogGroupName: aws.String("LogGroupName"), // Required } resp, err := svc.CreateLogGroup(params) if err != nil { if awsErr, ok := err.(awserr.Error); ok { // Generic AWS Error with Code, Message, and original error (if any) fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr()) if reqErr, ok := err.(awserr.RequestFailure); ok { // A service error occurred fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID()) } } else { // This case should never be hit, The SDK should alwsy return an // error which satisfies the awserr.Error interface. fmt.Println(err.Error()) } } // Pretty-print the response data. fmt.Println(awsutil.StringValue(resp)) }
Output:
func (*CloudWatchLogs) CreateLogGroupRequest ¶
func (c *CloudWatchLogs) CreateLogGroupRequest(input *CreateLogGroupInput) (req *aws.Request, output *CreateLogGroupOutput)
CreateLogGroupRequest generates a request for the CreateLogGroup operation.
func (*CloudWatchLogs) CreateLogStream ¶
func (c *CloudWatchLogs) CreateLogStream(input *CreateLogStreamInput) (*CreateLogStreamOutput, error)
Creates a new log stream in the specified log group. The name of the log stream must be unique within the log group. There is no limit on the number of log streams that can exist in a log group.
You must use the following guidelines when naming a log stream: Log stream
names can be between 1 and 512 characters long. The ':' colon character is not allowed.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/awsutil" "github.com/aws/aws-sdk-go/service/cloudwatchlogs" ) func main() { svc := cloudwatchlogs.New(nil) params := &cloudwatchlogs.CreateLogStreamInput{ LogGroupName: aws.String("LogGroupName"), // Required LogStreamName: aws.String("LogStreamName"), // Required } resp, err := svc.CreateLogStream(params) if err != nil { if awsErr, ok := err.(awserr.Error); ok { // Generic AWS Error with Code, Message, and original error (if any) fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr()) if reqErr, ok := err.(awserr.RequestFailure); ok { // A service error occurred fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID()) } } else { // This case should never be hit, The SDK should alwsy return an // error which satisfies the awserr.Error interface. fmt.Println(err.Error()) } } // Pretty-print the response data. fmt.Println(awsutil.StringValue(resp)) }
Output:
func (*CloudWatchLogs) CreateLogStreamRequest ¶
func (c *CloudWatchLogs) CreateLogStreamRequest(input *CreateLogStreamInput) (req *aws.Request, output *CreateLogStreamOutput)
CreateLogStreamRequest generates a request for the CreateLogStream operation.
func (*CloudWatchLogs) DeleteLogGroup ¶
func (c *CloudWatchLogs) DeleteLogGroup(input *DeleteLogGroupInput) (*DeleteLogGroupOutput, error)
Deletes the log group with the specified name and permanently deletes all the archived log events associated with it.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/awsutil" "github.com/aws/aws-sdk-go/service/cloudwatchlogs" ) func main() { svc := cloudwatchlogs.New(nil) params := &cloudwatchlogs.DeleteLogGroupInput{ LogGroupName: aws.String("LogGroupName"), // Required } resp, err := svc.DeleteLogGroup(params) if err != nil { if awsErr, ok := err.(awserr.Error); ok { // Generic AWS Error with Code, Message, and original error (if any) fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr()) if reqErr, ok := err.(awserr.RequestFailure); ok { // A service error occurred fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID()) } } else { // This case should never be hit, The SDK should alwsy return an // error which satisfies the awserr.Error interface. fmt.Println(err.Error()) } } // Pretty-print the response data. fmt.Println(awsutil.StringValue(resp)) }
Output:
func (*CloudWatchLogs) DeleteLogGroupRequest ¶
func (c *CloudWatchLogs) DeleteLogGroupRequest(input *DeleteLogGroupInput) (req *aws.Request, output *DeleteLogGroupOutput)
DeleteLogGroupRequest generates a request for the DeleteLogGroup operation.
func (*CloudWatchLogs) DeleteLogStream ¶
func (c *CloudWatchLogs) DeleteLogStream(input *DeleteLogStreamInput) (*DeleteLogStreamOutput, error)
Deletes a log stream and permanently deletes all the archived log events associated with it.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/awsutil" "github.com/aws/aws-sdk-go/service/cloudwatchlogs" ) func main() { svc := cloudwatchlogs.New(nil) params := &cloudwatchlogs.DeleteLogStreamInput{ LogGroupName: aws.String("LogGroupName"), // Required LogStreamName: aws.String("LogStreamName"), // Required } resp, err := svc.DeleteLogStream(params) if err != nil { if awsErr, ok := err.(awserr.Error); ok { // Generic AWS Error with Code, Message, and original error (if any) fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr()) if reqErr, ok := err.(awserr.RequestFailure); ok { // A service error occurred fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID()) } } else { // This case should never be hit, The SDK should alwsy return an // error which satisfies the awserr.Error interface. fmt.Println(err.Error()) } } // Pretty-print the response data. fmt.Println(awsutil.StringValue(resp)) }
Output:
func (*CloudWatchLogs) DeleteLogStreamRequest ¶
func (c *CloudWatchLogs) DeleteLogStreamRequest(input *DeleteLogStreamInput) (req *aws.Request, output *DeleteLogStreamOutput)
DeleteLogStreamRequest generates a request for the DeleteLogStream operation.
func (*CloudWatchLogs) DeleteMetricFilter ¶
func (c *CloudWatchLogs) DeleteMetricFilter(input *DeleteMetricFilterInput) (*DeleteMetricFilterOutput, error)
Deletes a metric filter associated with the specified log group.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/awsutil" "github.com/aws/aws-sdk-go/service/cloudwatchlogs" ) func main() { svc := cloudwatchlogs.New(nil) params := &cloudwatchlogs.DeleteMetricFilterInput{ FilterName: aws.String("FilterName"), // Required LogGroupName: aws.String("LogGroupName"), // Required } resp, err := svc.DeleteMetricFilter(params) if err != nil { if awsErr, ok := err.(awserr.Error); ok { // Generic AWS Error with Code, Message, and original error (if any) fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr()) if reqErr, ok := err.(awserr.RequestFailure); ok { // A service error occurred fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID()) } } else { // This case should never be hit, The SDK should alwsy return an // error which satisfies the awserr.Error interface. fmt.Println(err.Error()) } } // Pretty-print the response data. fmt.Println(awsutil.StringValue(resp)) }
Output:
func (*CloudWatchLogs) DeleteMetricFilterRequest ¶
func (c *CloudWatchLogs) DeleteMetricFilterRequest(input *DeleteMetricFilterInput) (req *aws.Request, output *DeleteMetricFilterOutput)
DeleteMetricFilterRequest generates a request for the DeleteMetricFilter operation.
func (*CloudWatchLogs) DeleteRetentionPolicy ¶
func (c *CloudWatchLogs) DeleteRetentionPolicy(input *DeleteRetentionPolicyInput) (*DeleteRetentionPolicyOutput, error)
Deletes the retention policy of the specified log group. Log events would not expire if they belong to log groups without a retention policy.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/awsutil" "github.com/aws/aws-sdk-go/service/cloudwatchlogs" ) func main() { svc := cloudwatchlogs.New(nil) params := &cloudwatchlogs.DeleteRetentionPolicyInput{ LogGroupName: aws.String("LogGroupName"), // Required } resp, err := svc.DeleteRetentionPolicy(params) if err != nil { if awsErr, ok := err.(awserr.Error); ok { // Generic AWS Error with Code, Message, and original error (if any) fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr()) if reqErr, ok := err.(awserr.RequestFailure); ok { // A service error occurred fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID()) } } else { // This case should never be hit, The SDK should alwsy return an // error which satisfies the awserr.Error interface. fmt.Println(err.Error()) } } // Pretty-print the response data. fmt.Println(awsutil.StringValue(resp)) }
Output:
func (*CloudWatchLogs) DeleteRetentionPolicyRequest ¶
func (c *CloudWatchLogs) DeleteRetentionPolicyRequest(input *DeleteRetentionPolicyInput) (req *aws.Request, output *DeleteRetentionPolicyOutput)
DeleteRetentionPolicyRequest generates a request for the DeleteRetentionPolicy operation.
func (*CloudWatchLogs) DescribeLogGroups ¶
func (c *CloudWatchLogs) DescribeLogGroups(input *DescribeLogGroupsInput) (*DescribeLogGroupsOutput, error)
Returns all the log groups that are associated with the AWS account making the request. The list returned in the response is ASCII-sorted by log group name.
By default, this operation returns up to 50 log groups. If there are more
log groups to list, the response would contain a nextToken value in the response body. You can also limit the number of log groups returned in the response by specifying the limit parameter in the request.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/awsutil" "github.com/aws/aws-sdk-go/service/cloudwatchlogs" ) func main() { svc := cloudwatchlogs.New(nil) params := &cloudwatchlogs.DescribeLogGroupsInput{ Limit: aws.Long(1), LogGroupNamePrefix: aws.String("LogGroupName"), NextToken: aws.String("NextToken"), } resp, err := svc.DescribeLogGroups(params) if err != nil { if awsErr, ok := err.(awserr.Error); ok { // Generic AWS Error with Code, Message, and original error (if any) fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr()) if reqErr, ok := err.(awserr.RequestFailure); ok { // A service error occurred fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID()) } } else { // This case should never be hit, The SDK should alwsy return an // error which satisfies the awserr.Error interface. fmt.Println(err.Error()) } } // Pretty-print the response data. fmt.Println(awsutil.StringValue(resp)) }
Output:
func (*CloudWatchLogs) DescribeLogGroupsPages ¶
func (c *CloudWatchLogs) DescribeLogGroupsPages(input *DescribeLogGroupsInput, fn func(p *DescribeLogGroupsOutput, lastPage bool) (shouldContinue bool)) error
func (*CloudWatchLogs) DescribeLogGroupsRequest ¶
func (c *CloudWatchLogs) DescribeLogGroupsRequest(input *DescribeLogGroupsInput) (req *aws.Request, output *DescribeLogGroupsOutput)
DescribeLogGroupsRequest generates a request for the DescribeLogGroups operation.
func (*CloudWatchLogs) DescribeLogStreams ¶
func (c *CloudWatchLogs) DescribeLogStreams(input *DescribeLogStreamsInput) (*DescribeLogStreamsOutput, error)
Returns all the log streams that are associated with the specified log group. The list returned in the response is ASCII-sorted by log stream name.
By default, this operation returns up to 50 log streams. If there are more
log streams to list, the response would contain a nextToken value in the response body. You can also limit the number of log streams returned in the response by specifying the limit parameter in the request. This operation has a limit of five transactions per second, after which transactions are throttled.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/awsutil" "github.com/aws/aws-sdk-go/service/cloudwatchlogs" ) func main() { svc := cloudwatchlogs.New(nil) params := &cloudwatchlogs.DescribeLogStreamsInput{ LogGroupName: aws.String("LogGroupName"), // Required Descending: aws.Boolean(true), Limit: aws.Long(1), LogStreamNamePrefix: aws.String("LogStreamName"), NextToken: aws.String("NextToken"), OrderBy: aws.String("OrderBy"), } resp, err := svc.DescribeLogStreams(params) if err != nil { if awsErr, ok := err.(awserr.Error); ok { // Generic AWS Error with Code, Message, and original error (if any) fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr()) if reqErr, ok := err.(awserr.RequestFailure); ok { // A service error occurred fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID()) } } else { // This case should never be hit, The SDK should alwsy return an // error which satisfies the awserr.Error interface. fmt.Println(err.Error()) } } // Pretty-print the response data. fmt.Println(awsutil.StringValue(resp)) }
Output:
func (*CloudWatchLogs) DescribeLogStreamsPages ¶
func (c *CloudWatchLogs) DescribeLogStreamsPages(input *DescribeLogStreamsInput, fn func(p *DescribeLogStreamsOutput, lastPage bool) (shouldContinue bool)) error
func (*CloudWatchLogs) DescribeLogStreamsRequest ¶
func (c *CloudWatchLogs) DescribeLogStreamsRequest(input *DescribeLogStreamsInput) (req *aws.Request, output *DescribeLogStreamsOutput)
DescribeLogStreamsRequest generates a request for the DescribeLogStreams operation.
func (*CloudWatchLogs) DescribeMetricFilters ¶
func (c *CloudWatchLogs) DescribeMetricFilters(input *DescribeMetricFiltersInput) (*DescribeMetricFiltersOutput, error)
Returns all the metrics filters associated with the specified log group. The list returned in the response is ASCII-sorted by filter name.
By default, this operation returns up to 50 metric filters. If there are
more metric filters to list, the response would contain a nextToken value in the response body. You can also limit the number of metric filters returned in the response by specifying the limit parameter in the request.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/awsutil" "github.com/aws/aws-sdk-go/service/cloudwatchlogs" ) func main() { svc := cloudwatchlogs.New(nil) params := &cloudwatchlogs.DescribeMetricFiltersInput{ LogGroupName: aws.String("LogGroupName"), // Required FilterNamePrefix: aws.String("FilterName"), Limit: aws.Long(1), NextToken: aws.String("NextToken"), } resp, err := svc.DescribeMetricFilters(params) if err != nil { if awsErr, ok := err.(awserr.Error); ok { // Generic AWS Error with Code, Message, and original error (if any) fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr()) if reqErr, ok := err.(awserr.RequestFailure); ok { // A service error occurred fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID()) } } else { // This case should never be hit, The SDK should alwsy return an // error which satisfies the awserr.Error interface. fmt.Println(err.Error()) } } // Pretty-print the response data. fmt.Println(awsutil.StringValue(resp)) }
Output:
func (*CloudWatchLogs) DescribeMetricFiltersPages ¶
func (c *CloudWatchLogs) DescribeMetricFiltersPages(input *DescribeMetricFiltersInput, fn func(p *DescribeMetricFiltersOutput, lastPage bool) (shouldContinue bool)) error
func (*CloudWatchLogs) DescribeMetricFiltersRequest ¶
func (c *CloudWatchLogs) DescribeMetricFiltersRequest(input *DescribeMetricFiltersInput) (req *aws.Request, output *DescribeMetricFiltersOutput)
DescribeMetricFiltersRequest generates a request for the DescribeMetricFilters operation.
func (*CloudWatchLogs) FilterLogEvents ¶
func (c *CloudWatchLogs) FilterLogEvents(input *FilterLogEventsInput) (*FilterLogEventsOutput, error)
Retrieves log events, optionally filtered by a filter pattern from the specified log group. You can provide an optional time range to filter the results on the event timestamp. You can limit the streams searched to an explicit list of logStreamNames.
By default, this operation returns as much matching log events as can fit
in a response size of 1MB, up to 10,000 log events, or all the events found within a time-bounded scan window. If the response includes a nextToken, then there is more data to search, and the search can be resumed with a new request providing the nextToken. The response will contain a list of searchedLogStreams that contains information about which streams were searched in the request and whether they have been searched completely or require further pagination. The limit parameter in the request. can be used to specify the maximum number of events to return in a page.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/awsutil" "github.com/aws/aws-sdk-go/service/cloudwatchlogs" ) func main() { svc := cloudwatchlogs.New(nil) params := &cloudwatchlogs.FilterLogEventsInput{ LogGroupName: aws.String("LogGroupName"), // Required EndTime: aws.Long(1), FilterPattern: aws.String("FilterPattern"), Interleaved: aws.Boolean(true), Limit: aws.Long(1), LogStreamNames: []*string{ aws.String("LogStreamName"), // Required // More values... }, NextToken: aws.String("NextToken"), StartTime: aws.Long(1), } resp, err := svc.FilterLogEvents(params) if err != nil { if awsErr, ok := err.(awserr.Error); ok { // Generic AWS Error with Code, Message, and original error (if any) fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr()) if reqErr, ok := err.(awserr.RequestFailure); ok { // A service error occurred fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID()) } } else { // This case should never be hit, The SDK should alwsy return an // error which satisfies the awserr.Error interface. fmt.Println(err.Error()) } } // Pretty-print the response data. fmt.Println(awsutil.StringValue(resp)) }
Output:
func (*CloudWatchLogs) FilterLogEventsRequest ¶
func (c *CloudWatchLogs) FilterLogEventsRequest(input *FilterLogEventsInput) (req *aws.Request, output *FilterLogEventsOutput)
FilterLogEventsRequest generates a request for the FilterLogEvents operation.
func (*CloudWatchLogs) GetLogEvents ¶
func (c *CloudWatchLogs) GetLogEvents(input *GetLogEventsInput) (*GetLogEventsOutput, error)
Retrieves log events from the specified log stream. You can provide an optional time range to filter the results on the event timestamp.
By default, this operation returns as much log events as can fit in a response
size of 1MB, up to 10,000 log events. The response will always include a nextForwardToken and a nextBackwardToken in the response body. You can use any of these tokens in subsequent GetLogEvents requests to paginate through events in either forward or backward direction. You can also limit the number of log events returned in the response by specifying the limit parameter in the request.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/awsutil" "github.com/aws/aws-sdk-go/service/cloudwatchlogs" ) func main() { svc := cloudwatchlogs.New(nil) params := &cloudwatchlogs.GetLogEventsInput{ LogGroupName: aws.String("LogGroupName"), // Required LogStreamName: aws.String("LogStreamName"), // Required EndTime: aws.Long(1), Limit: aws.Long(1), NextToken: aws.String("NextToken"), StartFromHead: aws.Boolean(true), StartTime: aws.Long(1), } resp, err := svc.GetLogEvents(params) if err != nil { if awsErr, ok := err.(awserr.Error); ok { // Generic AWS Error with Code, Message, and original error (if any) fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr()) if reqErr, ok := err.(awserr.RequestFailure); ok { // A service error occurred fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID()) } } else { // This case should never be hit, The SDK should alwsy return an // error which satisfies the awserr.Error interface. fmt.Println(err.Error()) } } // Pretty-print the response data. fmt.Println(awsutil.StringValue(resp)) }
Output:
func (*CloudWatchLogs) GetLogEventsPages ¶
func (c *CloudWatchLogs) GetLogEventsPages(input *GetLogEventsInput, fn func(p *GetLogEventsOutput, lastPage bool) (shouldContinue bool)) error
func (*CloudWatchLogs) GetLogEventsRequest ¶
func (c *CloudWatchLogs) GetLogEventsRequest(input *GetLogEventsInput) (req *aws.Request, output *GetLogEventsOutput)
GetLogEventsRequest generates a request for the GetLogEvents operation.
func (*CloudWatchLogs) PutLogEvents ¶
func (c *CloudWatchLogs) PutLogEvents(input *PutLogEventsInput) (*PutLogEventsOutput, error)
Uploads a batch of log events to the specified log stream.
Every PutLogEvents request must include the sequenceToken obtained from
the response of the previous request. An upload in a newly created log stream does not require a sequenceToken.
The batch of events must satisfy the following constraints: The maximum
batch size is 1,048,576 bytes, and this size is calculated as the sum of all event messages in UTF-8, plus 26 bytes for each log event. None of the log events in the batch can be more than 2 hours in the future. None of the log events in the batch can be older than 14 days or the retention period of the log group. The log events in the batch must be in chronological ordered by their timestamp. The maximum number of log events in a batch is 10,000.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/awsutil" "github.com/aws/aws-sdk-go/service/cloudwatchlogs" ) func main() { svc := cloudwatchlogs.New(nil) params := &cloudwatchlogs.PutLogEventsInput{ LogEvents: []*cloudwatchlogs.InputLogEvent{ // Required &cloudwatchlogs.InputLogEvent{ // Required Message: aws.String("EventMessage"), // Required Timestamp: aws.Long(1), // Required }, // More values... }, LogGroupName: aws.String("LogGroupName"), // Required LogStreamName: aws.String("LogStreamName"), // Required SequenceToken: aws.String("SequenceToken"), } resp, err := svc.PutLogEvents(params) if err != nil { if awsErr, ok := err.(awserr.Error); ok { // Generic AWS Error with Code, Message, and original error (if any) fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr()) if reqErr, ok := err.(awserr.RequestFailure); ok { // A service error occurred fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID()) } } else { // This case should never be hit, The SDK should alwsy return an // error which satisfies the awserr.Error interface. fmt.Println(err.Error()) } } // Pretty-print the response data. fmt.Println(awsutil.StringValue(resp)) }
Output:
func (*CloudWatchLogs) PutLogEventsRequest ¶
func (c *CloudWatchLogs) PutLogEventsRequest(input *PutLogEventsInput) (req *aws.Request, output *PutLogEventsOutput)
PutLogEventsRequest generates a request for the PutLogEvents operation.
func (*CloudWatchLogs) PutMetricFilter ¶
func (c *CloudWatchLogs) PutMetricFilter(input *PutMetricFilterInput) (*PutMetricFilterOutput, error)
Creates or updates a metric filter and associates it with the specified log group. Metric filters allow you to configure rules to extract metric data from log events ingested through PutLogEvents requests.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/awsutil" "github.com/aws/aws-sdk-go/service/cloudwatchlogs" ) func main() { svc := cloudwatchlogs.New(nil) params := &cloudwatchlogs.PutMetricFilterInput{ FilterName: aws.String("FilterName"), // Required FilterPattern: aws.String("FilterPattern"), // Required LogGroupName: aws.String("LogGroupName"), // Required MetricTransformations: []*cloudwatchlogs.MetricTransformation{ // Required &cloudwatchlogs.MetricTransformation{ // Required MetricName: aws.String("MetricName"), // Required MetricNamespace: aws.String("MetricNamespace"), // Required MetricValue: aws.String("MetricValue"), // Required }, // More values... }, } resp, err := svc.PutMetricFilter(params) if err != nil { if awsErr, ok := err.(awserr.Error); ok { // Generic AWS Error with Code, Message, and original error (if any) fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr()) if reqErr, ok := err.(awserr.RequestFailure); ok { // A service error occurred fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID()) } } else { // This case should never be hit, The SDK should alwsy return an // error which satisfies the awserr.Error interface. fmt.Println(err.Error()) } } // Pretty-print the response data. fmt.Println(awsutil.StringValue(resp)) }
Output:
func (*CloudWatchLogs) PutMetricFilterRequest ¶
func (c *CloudWatchLogs) PutMetricFilterRequest(input *PutMetricFilterInput) (req *aws.Request, output *PutMetricFilterOutput)
PutMetricFilterRequest generates a request for the PutMetricFilter operation.
func (*CloudWatchLogs) PutRetentionPolicy ¶
func (c *CloudWatchLogs) PutRetentionPolicy(input *PutRetentionPolicyInput) (*PutRetentionPolicyOutput, error)
Sets the retention of the specified log group. A retention policy allows you to configure the number of days you want to retain log events in the specified log group.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/awsutil" "github.com/aws/aws-sdk-go/service/cloudwatchlogs" ) func main() { svc := cloudwatchlogs.New(nil) params := &cloudwatchlogs.PutRetentionPolicyInput{ LogGroupName: aws.String("LogGroupName"), // Required RetentionInDays: aws.Long(1), // Required } resp, err := svc.PutRetentionPolicy(params) if err != nil { if awsErr, ok := err.(awserr.Error); ok { // Generic AWS Error with Code, Message, and original error (if any) fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr()) if reqErr, ok := err.(awserr.RequestFailure); ok { // A service error occurred fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID()) } } else { // This case should never be hit, The SDK should alwsy return an // error which satisfies the awserr.Error interface. fmt.Println(err.Error()) } } // Pretty-print the response data. fmt.Println(awsutil.StringValue(resp)) }
Output:
func (*CloudWatchLogs) PutRetentionPolicyRequest ¶
func (c *CloudWatchLogs) PutRetentionPolicyRequest(input *PutRetentionPolicyInput) (req *aws.Request, output *PutRetentionPolicyOutput)
PutRetentionPolicyRequest generates a request for the PutRetentionPolicy operation.
func (*CloudWatchLogs) TestMetricFilter ¶
func (c *CloudWatchLogs) TestMetricFilter(input *TestMetricFilterInput) (*TestMetricFilterOutput, error)
Tests the filter pattern of a metric filter against a sample of log event messages. You can use this operation to validate the correctness of a metric filter pattern.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/awserr" "github.com/aws/aws-sdk-go/aws/awsutil" "github.com/aws/aws-sdk-go/service/cloudwatchlogs" ) func main() { svc := cloudwatchlogs.New(nil) params := &cloudwatchlogs.TestMetricFilterInput{ FilterPattern: aws.String("FilterPattern"), // Required LogEventMessages: []*string{ // Required aws.String("EventMessage"), // Required // More values... }, } resp, err := svc.TestMetricFilter(params) if err != nil { if awsErr, ok := err.(awserr.Error); ok { // Generic AWS Error with Code, Message, and original error (if any) fmt.Println(awsErr.Code(), awsErr.Message(), awsErr.OrigErr()) if reqErr, ok := err.(awserr.RequestFailure); ok { // A service error occurred fmt.Println(reqErr.Code(), reqErr.Message(), reqErr.StatusCode(), reqErr.RequestID()) } } else { // This case should never be hit, The SDK should alwsy return an // error which satisfies the awserr.Error interface. fmt.Println(err.Error()) } } // Pretty-print the response data. fmt.Println(awsutil.StringValue(resp)) }
Output:
func (*CloudWatchLogs) TestMetricFilterRequest ¶
func (c *CloudWatchLogs) TestMetricFilterRequest(input *TestMetricFilterInput) (req *aws.Request, output *TestMetricFilterOutput)
TestMetricFilterRequest generates a request for the TestMetricFilter operation.
type CreateLogGroupInput ¶
type CreateLogGroupInput struct { LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` // contains filtered or unexported fields }
type CreateLogGroupOutput ¶
type CreateLogGroupOutput struct {
// contains filtered or unexported fields
}
type CreateLogStreamInput ¶
type CreateLogStreamOutput ¶
type CreateLogStreamOutput struct {
// contains filtered or unexported fields
}
type DeleteLogGroupInput ¶
type DeleteLogGroupInput struct { LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` // contains filtered or unexported fields }
type DeleteLogGroupOutput ¶
type DeleteLogGroupOutput struct {
// contains filtered or unexported fields
}
type DeleteLogStreamInput ¶
type DeleteLogStreamOutput ¶
type DeleteLogStreamOutput struct {
// contains filtered or unexported fields
}
type DeleteMetricFilterInput ¶
type DeleteMetricFilterOutput ¶
type DeleteMetricFilterOutput struct {
// contains filtered or unexported fields
}
type DeleteRetentionPolicyInput ¶
type DeleteRetentionPolicyInput struct { LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` // contains filtered or unexported fields }
type DeleteRetentionPolicyOutput ¶
type DeleteRetentionPolicyOutput struct {
// contains filtered or unexported fields
}
type DescribeLogGroupsInput ¶
type DescribeLogGroupsInput struct { // The maximum number of items returned in the response. If you don't specify // a value, the request would return up to 50 items. Limit *int64 `locationName:"limit" type:"integer"` LogGroupNamePrefix *string `locationName:"logGroupNamePrefix" type:"string"` // A string token used for pagination that points to the next page of results. // It must be a value obtained from the response of the previous DescribeLogGroups // request. NextToken *string `locationName:"nextToken" type:"string"` // contains filtered or unexported fields }
type DescribeLogGroupsOutput ¶
type DescribeLogGroupsOutput struct { // A list of log groups. LogGroups []*LogGroup `locationName:"logGroups" type:"list"` // A string token used for pagination that points to the next page of results. // It must be a value obtained from the response of the previous request. The // token expires after 24 hours. NextToken *string `locationName:"nextToken" type:"string"` // contains filtered or unexported fields }
type DescribeLogStreamsInput ¶
type DescribeLogStreamsInput struct { // If set to true, results are returned in descending order. If you don't specify // a value or set it to false, results are returned in ascending order. Descending *bool `locationName:"descending" type:"boolean"` // The maximum number of items returned in the response. If you don't specify // a value, the request would return up to 50 items. Limit *int64 `locationName:"limit" type:"integer"` LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` // Will only return log streams that match the provided logStreamNamePrefix. // If you don't specify a value, no prefix filter is applied. LogStreamNamePrefix *string `locationName:"logStreamNamePrefix" type:"string"` // A string token used for pagination that points to the next page of results. // It must be a value obtained from the response of the previous DescribeLogStreams // request. NextToken *string `locationName:"nextToken" type:"string"` // Specifies what to order the returned log streams by. Valid arguments are // 'LogStreamName' or 'LastEventTime'. If you don't specify a value, results // are ordered by LogStreamName. If 'LastEventTime' is chosen, the request cannot // also contain a logStreamNamePrefix. OrderBy *string `locationName:"orderBy" type:"string"` // contains filtered or unexported fields }
type DescribeLogStreamsOutput ¶
type DescribeLogStreamsOutput struct { // A list of log streams. LogStreams []*LogStream `locationName:"logStreams" type:"list"` // A string token used for pagination that points to the next page of results. // It must be a value obtained from the response of the previous request. The // token expires after 24 hours. NextToken *string `locationName:"nextToken" type:"string"` // contains filtered or unexported fields }
type DescribeMetricFiltersInput ¶
type DescribeMetricFiltersInput struct { // The name of the metric filter. FilterNamePrefix *string `locationName:"filterNamePrefix" type:"string"` // The maximum number of items returned in the response. If you don't specify // a value, the request would return up to 50 items. Limit *int64 `locationName:"limit" type:"integer"` LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` // A string token used for pagination that points to the next page of results. // It must be a value obtained from the response of the previous DescribeMetricFilters // request. NextToken *string `locationName:"nextToken" type:"string"` // contains filtered or unexported fields }
type DescribeMetricFiltersOutput ¶
type DescribeMetricFiltersOutput struct { MetricFilters []*MetricFilter `locationName:"metricFilters" type:"list"` // A string token used for pagination that points to the next page of results. // It must be a value obtained from the response of the previous request. The // token expires after 24 hours. NextToken *string `locationName:"nextToken" type:"string"` // contains filtered or unexported fields }
type FilterLogEventsInput ¶
type FilterLogEventsInput struct { // A unix timestamp indicating the end time of the range for the request. If // provided, events with a timestamp later than this time will not be returned. EndTime *int64 `locationName:"endTime" type:"long"` // A valid CloudWatch Logs filter pattern to use for filtering the response. // If not provided, all the events are matched. FilterPattern *string `locationName:"filterPattern" type:"string"` // If provided, the API will make a best effort to provide responses that contain // events from multiple log streams within the log group interleaved in a single // response. If not provided, all the matched log events in the first log stream // will be searched first, then those in the next log stream, etc. Interleaved *bool `locationName:"interleaved" type:"boolean"` // The maximum number of events to return in a page of results. Default is 10,000 // events. Limit *int64 `locationName:"limit" type:"integer"` // The name of the log group to query LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` // Optional list of log stream names within the specified log group to search. // Defaults to all the log streams in the log group. LogStreamNames []*string `locationName:"logStreamNames" type:"list"` // A pagination token obtained from a FilterLogEvents response to continue paginating // the FilterLogEvents results. NextToken *string `locationName:"nextToken" type:"string"` // A unix timestamp indicating the start time of the range for the request. // If provided, events with a timestamp prior to this time will not be returned. StartTime *int64 `locationName:"startTime" type:"long"` // contains filtered or unexported fields }
type FilterLogEventsOutput ¶
type FilterLogEventsOutput struct { // A list of FilteredLogEvent objects representing the matched events from the // request. Events []*FilteredLogEvent `locationName:"events" type:"list"` // A pagination token obtained from a FilterLogEvents response to continue paginating // the FilterLogEvents results. NextToken *string `locationName:"nextToken" type:"string"` // A list of SearchedLogStream objects indicating which log streams have been // searched in this request and whether each has been searched completely or // still has more to be paginated. SearchedLogStreams []*SearchedLogStream `locationName:"searchedLogStreams" type:"list"` // contains filtered or unexported fields }
type FilteredLogEvent ¶
type FilteredLogEvent struct { // A unique identifier for this event. EventID *string `locationName:"eventId" type:"string"` // A point in time expressed as the number milliseconds since Jan 1, 1970 00:00:00 // UTC. IngestionTime *int64 `locationName:"ingestionTime" type:"long"` // The name of the log stream this event belongs to. LogStreamName *string `locationName:"logStreamName" type:"string"` Message *string `locationName:"message" type:"string"` // A point in time expressed as the number milliseconds since Jan 1, 1970 00:00:00 // UTC. Timestamp *int64 `locationName:"timestamp" type:"long"` // contains filtered or unexported fields }
Represents a matched event from a FilterLogEvents request.
type GetLogEventsInput ¶
type GetLogEventsInput struct { // A point in time expressed as the number milliseconds since Jan 1, 1970 00:00:00 // UTC. EndTime *int64 `locationName:"endTime" type:"long"` // The maximum number of log events returned in the response. If you don't specify // a value, the request would return as many log events as can fit in a response // size of 1MB, up to 10,000 log events. Limit *int64 `locationName:"limit" type:"integer"` LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` LogStreamName *string `locationName:"logStreamName" type:"string" required:"true"` // A string token used for pagination that points to the next page of results. // It must be a value obtained from the nextForwardToken or nextBackwardToken // fields in the response of the previous GetLogEvents request. NextToken *string `locationName:"nextToken" type:"string"` // If set to true, the earliest log events would be returned first. The default // is false (the latest log events are returned first). StartFromHead *bool `locationName:"startFromHead" type:"boolean"` // A point in time expressed as the number milliseconds since Jan 1, 1970 00:00:00 // UTC. StartTime *int64 `locationName:"startTime" type:"long"` // contains filtered or unexported fields }
type GetLogEventsOutput ¶
type GetLogEventsOutput struct { Events []*OutputLogEvent `locationName:"events" type:"list"` // A string token used for pagination that points to the next page of results. // It must be a value obtained from the response of the previous request. The // token expires after 24 hours. NextBackwardToken *string `locationName:"nextBackwardToken" type:"string"` // A string token used for pagination that points to the next page of results. // It must be a value obtained from the response of the previous request. The // token expires after 24 hours. NextForwardToken *string `locationName:"nextForwardToken" type:"string"` // contains filtered or unexported fields }
type InputLogEvent ¶
type InputLogEvent struct { Message *string `locationName:"message" type:"string" required:"true"` // A point in time expressed as the number milliseconds since Jan 1, 1970 00:00:00 // UTC. Timestamp *int64 `locationName:"timestamp" type:"long" required:"true"` // contains filtered or unexported fields }
A log event is a record of some activity that was recorded by the application or resource being monitored. The log event record that Amazon CloudWatch Logs understands contains two properties: the timestamp of when the event occurred, and the raw event message.
type LogGroup ¶
type LogGroup struct { ARN *string `locationName:"arn" type:"string"` // A point in time expressed as the number milliseconds since Jan 1, 1970 00:00:00 // UTC. CreationTime *int64 `locationName:"creationTime" type:"long"` LogGroupName *string `locationName:"logGroupName" type:"string"` // The number of metric filters associated with the log group. MetricFilterCount *int64 `locationName:"metricFilterCount" type:"integer"` // Specifies the number of days you want to retain log events in the specified // log group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, // 365, 400, 545, 731, 1827, 3653. RetentionInDays *int64 `locationName:"retentionInDays" type:"integer"` StoredBytes *int64 `locationName:"storedBytes" type:"long"` // contains filtered or unexported fields }
type LogStream ¶
type LogStream struct { ARN *string `locationName:"arn" type:"string"` // A point in time expressed as the number milliseconds since Jan 1, 1970 00:00:00 // UTC. CreationTime *int64 `locationName:"creationTime" type:"long"` // A point in time expressed as the number milliseconds since Jan 1, 1970 00:00:00 // UTC. FirstEventTimestamp *int64 `locationName:"firstEventTimestamp" type:"long"` // A point in time expressed as the number milliseconds since Jan 1, 1970 00:00:00 // UTC. LastEventTimestamp *int64 `locationName:"lastEventTimestamp" type:"long"` // A point in time expressed as the number milliseconds since Jan 1, 1970 00:00:00 // UTC. LastIngestionTime *int64 `locationName:"lastIngestionTime" type:"long"` LogStreamName *string `locationName:"logStreamName" type:"string"` StoredBytes *int64 `locationName:"storedBytes" type:"long"` // A string token used for making PutLogEvents requests. A sequenceToken can // only be used once, and PutLogEvents requests must include the sequenceToken // obtained from the response of the previous request. UploadSequenceToken *string `locationName:"uploadSequenceToken" type:"string"` // contains filtered or unexported fields }
A log stream is sequence of log events that share the same emitter.
type MetricFilter ¶
type MetricFilter struct { // A point in time expressed as the number milliseconds since Jan 1, 1970 00:00:00 // UTC. CreationTime *int64 `locationName:"creationTime" type:"long"` // The name of the metric filter. FilterName *string `locationName:"filterName" type:"string"` // A symbolic description of how Amazon CloudWatch Logs should interpret the // data in each log entry. For example, a log entry may contain timestamps, // IP addresses, strings, and so on. You use the pattern to specify what to // look for in the log stream. FilterPattern *string `locationName:"filterPattern" type:"string"` MetricTransformations []*MetricTransformation `locationName:"metricTransformations" type:"list"` // contains filtered or unexported fields }
Metric filters can be used to express how Amazon CloudWatch Logs would extract metric observations from ingested log events and transform them to metric data in a CloudWatch metric.
type MetricFilterMatchRecord ¶
type MetricTransformation ¶
type MetricTransformation struct { // The name of the CloudWatch metric to which the monitored log information // should be published. For example, you may publish to a metric called ErrorCount. MetricName *string `locationName:"metricName" type:"string" required:"true"` // The destination namespace of the new CloudWatch metric. MetricNamespace *string `locationName:"metricNamespace" type:"string" required:"true"` // What to publish to the metric. For example, if you're counting the occurrences // of a particular term like "Error", the value will be "1" for each occurrence. // If you're counting the bytes transferred the published value will be the // value in the log event. MetricValue *string `locationName:"metricValue" type:"string" required:"true"` // contains filtered or unexported fields }
type OutputLogEvent ¶
type OutputLogEvent struct { // A point in time expressed as the number milliseconds since Jan 1, 1970 00:00:00 // UTC. IngestionTime *int64 `locationName:"ingestionTime" type:"long"` Message *string `locationName:"message" type:"string"` // A point in time expressed as the number milliseconds since Jan 1, 1970 00:00:00 // UTC. Timestamp *int64 `locationName:"timestamp" type:"long"` // contains filtered or unexported fields }
type PutLogEventsInput ¶
type PutLogEventsInput struct { // A list of events belonging to a log stream. LogEvents []*InputLogEvent `locationName:"logEvents" type:"list" required:"true"` LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` LogStreamName *string `locationName:"logStreamName" type:"string" required:"true"` // A string token that must be obtained from the response of the previous PutLogEvents // request. SequenceToken *string `locationName:"sequenceToken" type:"string"` // contains filtered or unexported fields }
type PutLogEventsOutput ¶
type PutLogEventsOutput struct { // A string token used for making PutLogEvents requests. A sequenceToken can // only be used once, and PutLogEvents requests must include the sequenceToken // obtained from the response of the previous request. NextSequenceToken *string `locationName:"nextSequenceToken" type:"string"` RejectedLogEventsInfo *RejectedLogEventsInfo `locationName:"rejectedLogEventsInfo" type:"structure"` // contains filtered or unexported fields }
type PutMetricFilterInput ¶
type PutMetricFilterInput struct { // The name of the metric filter. FilterName *string `locationName:"filterName" type:"string" required:"true"` // A symbolic description of how Amazon CloudWatch Logs should interpret the // data in each log entry. For example, a log entry may contain timestamps, // IP addresses, strings, and so on. You use the pattern to specify what to // look for in the log stream. FilterPattern *string `locationName:"filterPattern" type:"string" required:"true"` LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` MetricTransformations []*MetricTransformation `locationName:"metricTransformations" type:"list" required:"true"` // contains filtered or unexported fields }
type PutMetricFilterOutput ¶
type PutMetricFilterOutput struct {
// contains filtered or unexported fields
}
type PutRetentionPolicyInput ¶
type PutRetentionPolicyInput struct { LogGroupName *string `locationName:"logGroupName" type:"string" required:"true"` // Specifies the number of days you want to retain log events in the specified // log group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, // 365, 400, 545, 731, 1827, 3653. RetentionInDays *int64 `locationName:"retentionInDays" type:"integer" required:"true"` // contains filtered or unexported fields }
type PutRetentionPolicyOutput ¶
type PutRetentionPolicyOutput struct {
// contains filtered or unexported fields
}
type RejectedLogEventsInfo ¶
type RejectedLogEventsInfo struct { ExpiredLogEventEndIndex *int64 `locationName:"expiredLogEventEndIndex" type:"integer"` TooNewLogEventStartIndex *int64 `locationName:"tooNewLogEventStartIndex" type:"integer"` TooOldLogEventEndIndex *int64 `locationName:"tooOldLogEventEndIndex" type:"integer"` // contains filtered or unexported fields }
type SearchedLogStream ¶
type SearchedLogStream struct { // The name of the log stream. LogStreamName *string `locationName:"logStreamName" type:"string"` // Indicates whether all the events in this log stream were searched or more // data exists to search by paginating further. SearchedCompletely *bool `locationName:"searchedCompletely" type:"boolean"` // contains filtered or unexported fields }
An object indicating the search status of a log stream in a FilterLogEvents request.
type TestMetricFilterInput ¶
type TestMetricFilterInput struct { // A symbolic description of how Amazon CloudWatch Logs should interpret the // data in each log entry. For example, a log entry may contain timestamps, // IP addresses, strings, and so on. You use the pattern to specify what to // look for in the log stream. FilterPattern *string `locationName:"filterPattern" type:"string" required:"true"` LogEventMessages []*string `locationName:"logEventMessages" type:"list" required:"true"` // contains filtered or unexported fields }
type TestMetricFilterOutput ¶
type TestMetricFilterOutput struct { Matches []*MetricFilterMatchRecord `locationName:"matches" type:"list"` // contains filtered or unexported fields }
Directories ¶
Path | Synopsis |
---|---|
Package cloudwatchlogsiface provides an interface for the Amazon CloudWatch Logs.
|
Package cloudwatchlogsiface provides an interface for the Amazon CloudWatch Logs. |