types

package
v1.15.6 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 22, 2022 License: Apache-2.0 Imports: 4 Imported by: 1

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type DataPoint

type DataPoint struct {

	// The time, in epoch format, associated with a particular Value.
	//
	// This member is required.
	Timestamp *time.Time

	// The actual value associated with a particular Timestamp.
	//
	// This member is required.
	Value *float64
	// contains filtered or unexported fields
}

A timestamp, and a single numerical value, which together represent a measurement at a particular point in time.

type DetailStatus added in v1.4.0

type DetailStatus string
const (
	DetailStatusAvailable   DetailStatus = "AVAILABLE"
	DetailStatusProcessing  DetailStatus = "PROCESSING"
	DetailStatusUnavailable DetailStatus = "UNAVAILABLE"
)

Enum values for DetailStatus

func (DetailStatus) Values added in v1.4.0

func (DetailStatus) Values() []DetailStatus

Values returns all known values for DetailStatus. Note that this can be expanded in the future, and so it is only as up to date as the client. The ordering of this slice is not guaranteed to be stable across updates.

type DimensionDetail added in v1.12.0

type DimensionDetail struct {

	// The identifier of a dimension.
	Identifier *string
	// contains filtered or unexported fields
}

The information about a dimension.

type DimensionGroup

type DimensionGroup struct {

	// The name of the dimension group. Valid values are as follows:
	//
	// * db - The name
	// of the database to which the client is connected. The following values are
	// permitted:
	//
	// * Aurora PostgreSQL
	//
	// * Amazon RDS PostgreSQL
	//
	// * Aurora MySQL
	//
	// *
	// Amazon RDS MySQL
	//
	// * Amazon RDS MariaDB
	//
	// * Amazon DocumentDB
	//
	// * db.application -
	// The name of the application that is connected to the database. The following
	// values are permitted:
	//
	// * Aurora PostgreSQL
	//
	// * Amazon RDS PostgreSQL
	//
	// * Amazon
	// DocumentDB
	//
	// * db.host - The host name of the connected client (all engines).
	//
	// *
	// db.query - The query that is currently running (only Amazon DocumentDB).
	//
	// *
	// db.query_tokenized - The digest query (only Amazon DocumentDB).
	//
	// *
	// db.session_type - The type of the current session (only Aurora PostgreSQL and
	// RDS PostgreSQL).
	//
	// * db.sql - The text of the SQL statement that is currently
	// running (all engines except Amazon DocumentDB).
	//
	// * db.sql_tokenized - The SQL
	// digest (all engines except Amazon DocumentDB).
	//
	// * db.user - The user logged in
	// to the database (all engines except Amazon DocumentDB).
	//
	// * db.wait_event - The
	// event for which the database backend is waiting (all engines except Amazon
	// DocumentDB).
	//
	// * db.wait_event_type - The type of event for which the database
	// backend is waiting (all engines except Amazon DocumentDB).
	//
	// * db.wait_state -
	// The event for which the database backend is waiting (only Amazon DocumentDB).
	//
	// This member is required.
	Group *string

	// A list of specific dimensions from a dimension group. If this parameter is not
	// present, then it signifies that all of the dimensions in the group were
	// requested, or are present in the response. Valid values for elements in the
	// Dimensions array are:
	//
	// * db.application.name - The name of the application that
	// is connected to the database. Valid values are as follows:
	//
	// * Aurora
	// PostgreSQL
	//
	// * Amazon RDS PostgreSQL
	//
	// * Amazon DocumentDB
	//
	// * db.host.id - The
	// host ID of the connected client (all engines).
	//
	// * db.host.name - The host name
	// of the connected client (all engines).
	//
	// * db.name - The name of the database to
	// which the client is connected. Valid values are as follows:
	//
	// * Aurora
	// PostgreSQL
	//
	// * Amazon RDS PostgreSQL
	//
	// * Aurora MySQL
	//
	// * Amazon RDS MySQL
	//
	// *
	// Amazon RDS MariaDB
	//
	// * Amazon DocumentDB
	//
	// * db.query.id - The query ID generated
	// by Performance Insights (only Amazon DocumentDB).
	//
	// * db.query.db_id - The query
	// ID generated by the database (only Amazon DocumentDB).
	//
	// * db.query.statement -
	// The text of the query that is being run (only Amazon DocumentDB).
	//
	// *
	// db.query.tokenized_id
	//
	// * db.query.tokenized.id - The query digest ID generated
	// by Performance Insights (only Amazon DocumentDB).
	//
	// * db.query.tokenized.db_id -
	// The query digest ID generated by Performance Insights (only Amazon
	// DocumentDB).
	//
	// * db.query.tokenized.statement - The text of the query digest
	// (only Amazon DocumentDB).
	//
	// * db.session_type.name - The type of the current
	// session (only Amazon DocumentDB).
	//
	// * db.sql.id - The hash of the full,
	// non-tokenized SQL statement generated by Performance Insights (all engines
	// except Amazon DocumentDB).
	//
	// * db.sql.db_id - Either the SQL ID generated by the
	// database engine, or a value generated by Performance Insights that begins with
	// pi- (all engines except Amazon DocumentDB).
	//
	// * db.sql.statement - The full text
	// of the SQL statement that is running, as in SELECT * FROM employees (all engines
	// except Amazon DocumentDB)
	//
	// * db.sql.tokenized_id
	//
	// * db.sql_tokenized.id - The
	// hash of the SQL digest generated by Performance Insights (all engines except
	// Amazon DocumentDB). In the console, db.sql_tokenized.id is called the Support ID
	// because Amazon Web Services Support can look at this data to help you
	// troubleshoot database issues.
	//
	// * db.sql_tokenized.db_id - Either the native
	// database ID used to refer to the SQL statement, or a synthetic ID such as
	// pi-2372568224 that Performance Insights generates if the native database ID
	// isn't available (all engines except Amazon DocumentDB).
	//
	// *
	// db.sql_tokenized.statement - The text of the SQL digest, as in SELECT * FROM
	// employees WHERE employee_id = ? (all engines except Amazon DocumentDB)
	//
	// *
	// db.user.id - The ID of the user logged in to the database (all engines except
	// Amazon DocumentDB).
	//
	// * db.user.name - The name of the user logged in to the
	// database (all engines except Amazon DocumentDB).
	//
	// * db.wait_event.name - The
	// event for which the backend is waiting (all engines except Amazon
	// DocumentDB).
	//
	// * db.wait_event.type - The type of event for which the backend is
	// waiting (all engines except Amazon DocumentDB).
	//
	// * db.wait_event_type.name - The
	// name of the event type for which the backend is waiting (all engines except
	// Amazon DocumentDB).
	//
	// * db.wait_state.name - The event for which the backend is
	// waiting (only Amazon DocumentDB).
	Dimensions []string

	// The maximum number of items to fetch for this dimension group.
	Limit *int32
	// contains filtered or unexported fields
}

A logical grouping of Performance Insights metrics for a related subject area. For example, the db.sql dimension group consists of the following dimensions:

* db.sql.id - The hash of a running SQL statement, generated by Performance Insights.

* db.sql.db_id - Either the SQL ID generated by the database engine, or a value generated by Performance Insights that begins with pi-.

* db.sql.statement - The full text of the SQL statement that is running, for example, SELECT * FROM employees.

* db.sql_tokenized.id - The hash of the SQL digest generated by Performance Insights.

Each response element returns a maximum of 500 bytes. For larger elements, such as SQL statements, only the first 500 bytes are returned.

type DimensionGroupDetail added in v1.12.0

type DimensionGroupDetail struct {

	// The dimensions within a dimension group.
	Dimensions []DimensionDetail

	// The name of the dimension group.
	Group *string
	// contains filtered or unexported fields
}

Information about dimensions within a dimension group.

type DimensionKeyDescription

type DimensionKeyDescription struct {

	// A map that contains the value for each additional metric.
	AdditionalMetrics map[string]float64

	// A map of name-value pairs for the dimensions in the group.
	Dimensions map[string]string

	// If PartitionBy was specified, PartitionKeys contains the dimensions that were.
	Partitions []float64

	// The aggregated metric value for the dimensions, over the requested time range.
	Total *float64
	// contains filtered or unexported fields
}

An object that includes the requested dimension key values and aggregated metric values within a dimension group.

type DimensionKeyDetail added in v1.4.0

type DimensionKeyDetail struct {

	// The full name of the dimension. The full name includes the group name and key
	// name. The following values are valid:
	//
	// * db.query.statement (Amazon
	// DocumentDB)
	//
	// * db.sql.statement (Amazon RDS and Aurora)
	Dimension *string

	// The status of the dimension detail data. Possible values include the
	// following:
	//
	// * AVAILABLE - The dimension detail data is ready to be retrieved.
	//
	// *
	// PROCESSING - The dimension detail data isn't ready to be retrieved because more
	// processing time is required. If the requested detail data has the status
	// PROCESSING, Performance Insights returns the truncated query.
	//
	// * UNAVAILABLE -
	// The dimension detail data could not be collected successfully.
	Status DetailStatus

	// The value of the dimension detail data. Depending on the return status, this
	// value is either the full or truncated SQL query for the following dimensions:
	//
	// *
	// db.query.statement (Amazon DocumentDB)
	//
	// * db.sql.statement (Amazon RDS and
	// Aurora)
	Value *string
	// contains filtered or unexported fields
}

An object that describes the details for a specified dimension.

type FeatureMetadata added in v1.12.0

type FeatureMetadata struct {

	// The status of the feature on the DB instance. Possible values include the
	// following:
	//
	// * ENABLED - The feature is enabled on the instance.
	//
	// * DISABLED -
	// The feature is disabled on the instance.
	//
	// * UNSUPPORTED - The feature isn't
	// supported on the instance.
	//
	// * ENABLED_PENDING_REBOOT - The feature is enabled on
	// the instance but requires a reboot to take effect.
	//
	// * DISABLED_PENDING_REBOOT -
	// The feature is disabled on the instance but requires a reboot to take effect.
	//
	// *
	// UNKNOWN - The feature status couldn't be determined.
	Status FeatureStatus
	// contains filtered or unexported fields
}

The metadata for a feature. For example, the metadata might indicate that a feature is turned on or off on a specific DB instance.

type FeatureStatus added in v1.12.0

type FeatureStatus string
const (
	FeatureStatusEnabled               FeatureStatus = "ENABLED"
	FeatureStatusDisabled              FeatureStatus = "DISABLED"
	FeatureStatusUnsupported           FeatureStatus = "UNSUPPORTED"
	FeatureStatusEnabledPendingReboot  FeatureStatus = "ENABLED_PENDING_REBOOT"
	FeatureStatusDisabledPendingReboot FeatureStatus = "DISABLED_PENDING_REBOOT"
	FeatureStatusUnknown               FeatureStatus = "UNKNOWN"
)

Enum values for FeatureStatus

func (FeatureStatus) Values added in v1.12.0

func (FeatureStatus) Values() []FeatureStatus

Values returns all known values for FeatureStatus. Note that this can be expanded in the future, and so it is only as up to date as the client. The ordering of this slice is not guaranteed to be stable across updates.

type InternalServiceError

type InternalServiceError struct {
	Message *string
	// contains filtered or unexported fields
}

The request failed due to an unknown error.

func (*InternalServiceError) Error

func (e *InternalServiceError) Error() string

func (*InternalServiceError) ErrorCode

func (e *InternalServiceError) ErrorCode() string

func (*InternalServiceError) ErrorFault

func (e *InternalServiceError) ErrorFault() smithy.ErrorFault

func (*InternalServiceError) ErrorMessage

func (e *InternalServiceError) ErrorMessage() string

type InvalidArgumentException

type InvalidArgumentException struct {
	Message *string
	// contains filtered or unexported fields
}

One of the arguments provided is invalid for this request.

func (*InvalidArgumentException) Error

func (e *InvalidArgumentException) Error() string

func (*InvalidArgumentException) ErrorCode

func (e *InvalidArgumentException) ErrorCode() string

func (*InvalidArgumentException) ErrorFault

func (e *InvalidArgumentException) ErrorFault() smithy.ErrorFault

func (*InvalidArgumentException) ErrorMessage

func (e *InvalidArgumentException) ErrorMessage() string

type MetricDimensionGroups added in v1.12.0

type MetricDimensionGroups struct {

	// The available dimension groups for a metric type.
	Groups []DimensionGroupDetail

	// The metric type to which the dimension information belongs.
	Metric *string
	// contains filtered or unexported fields
}

The available dimension information for a metric type.

type MetricKeyDataPoints

type MetricKeyDataPoints struct {

	// An array of timestamp-value pairs, representing measurements over a period of
	// time.
	DataPoints []DataPoint

	// The dimensions to which the data points apply.
	Key *ResponseResourceMetricKey
	// contains filtered or unexported fields
}

A time-ordered series of data points, corresponding to a dimension of a Performance Insights metric.

type MetricQuery

type MetricQuery struct {

	// The name of a Performance Insights metric to be measured. Valid values for
	// Metric are:
	//
	// * db.load.avg - A scaled representation of the number of active
	// sessions for the database engine.
	//
	// * db.sampledload.avg - The raw number of
	// active sessions for the database engine.
	//
	// * The counter metrics listed in
	// Performance Insights operating system counters
	// (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights_Counters.html#USER_PerfInsights_Counters.OS)
	// in the Amazon Aurora User Guide.
	//
	// If the number of active sessions is less than
	// an internal Performance Insights threshold, db.load.avg and db.sampledload.avg
	// are the same value. If the number of active sessions is greater than the
	// internal threshold, Performance Insights samples the active sessions, with
	// db.load.avg showing the scaled values, db.sampledload.avg showing the raw
	// values, and db.sampledload.avg less than db.load.avg. For most use cases, you
	// can query db.load.avg only.
	//
	// This member is required.
	Metric *string

	// One or more filters to apply in the request. Restrictions:
	//
	// * Any number of
	// filters by the same dimension, as specified in the GroupBy parameter.
	//
	// * A
	// single filter for any other dimension in this dimension group.
	Filter map[string]string

	// A specification for how to aggregate the data points from a query result. You
	// must specify a valid dimension group. Performance Insights will return all of
	// the dimensions within that group, unless you provide the names of specific
	// dimensions within that group. You can also request that Performance Insights
	// return a limited number of values for a dimension.
	GroupBy *DimensionGroup
	// contains filtered or unexported fields
}

A single query to be processed. You must provide the metric to query. If no other parameters are specified, Performance Insights returns all data points for the specified metric. Optionally, you can request that the data points be aggregated by dimension group (GroupBy), and return only those data points that match your criteria (Filter).

type NotAuthorizedException

type NotAuthorizedException struct {
	Message *string
	// contains filtered or unexported fields
}

The user is not authorized to perform this request.

func (*NotAuthorizedException) Error

func (e *NotAuthorizedException) Error() string

func (*NotAuthorizedException) ErrorCode

func (e *NotAuthorizedException) ErrorCode() string

func (*NotAuthorizedException) ErrorFault

func (e *NotAuthorizedException) ErrorFault() smithy.ErrorFault

func (*NotAuthorizedException) ErrorMessage

func (e *NotAuthorizedException) ErrorMessage() string

type ResponsePartitionKey

type ResponsePartitionKey struct {

	// A dimension map that contains the dimensions for this partition.
	//
	// This member is required.
	Dimensions map[string]string
	// contains filtered or unexported fields
}

If PartitionBy was specified in a DescribeDimensionKeys request, the dimensions are returned in an array. Each element in the array specifies one dimension.

type ResponseResourceMetric added in v1.12.0

type ResponseResourceMetric struct {

	// The description of the metric.
	Description *string

	// The full name of the metric.
	Metric *string

	// The unit of the metric.
	Unit *string
	// contains filtered or unexported fields
}

An object that contains the full name, description, and unit of a metric.

type ResponseResourceMetricKey

type ResponseResourceMetricKey struct {

	// The name of a Performance Insights metric to be measured. Valid values for
	// Metric are:
	//
	// * db.load.avg - A scaled representation of the number of active
	// sessions for the database engine.
	//
	// * db.sampledload.avg - The raw number of
	// active sessions for the database engine.
	//
	// * The counter metrics listed in
	// Performance Insights operating system counters
	// (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights_Counters.html#USER_PerfInsights_Counters.OS)
	// in the Amazon Aurora User Guide.
	//
	// If the number of active sessions is less than
	// an internal Performance Insights threshold, db.load.avg and db.sampledload.avg
	// are the same value. If the number of active sessions is greater than the
	// internal threshold, Performance Insights samples the active sessions, with
	// db.load.avg showing the scaled values, db.sampledload.avg showing the raw
	// values, and db.sampledload.avg less than db.load.avg. For most use cases, you
	// can query db.load.avg only.
	//
	// This member is required.
	Metric *string

	// The valid dimensions for the metric.
	Dimensions map[string]string
	// contains filtered or unexported fields
}

An object describing a Performance Insights metric and one or more dimensions for that metric.

type ServiceType

type ServiceType string
const (
	ServiceTypeRds   ServiceType = "RDS"
	ServiceTypeDocdb ServiceType = "DOCDB"
)

Enum values for ServiceType

func (ServiceType) Values added in v0.29.0

func (ServiceType) Values() []ServiceType

Values returns all known values for ServiceType. Note that this can be expanded in the future, and so it is only as up to date as the client. The ordering of this slice is not guaranteed to be stable across updates.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL