software.amazon.awssdk.services.rds.model.PerformanceInsightsMetricQuery Maven / Gradle / Ivy
Show all versions of rds Show documentation
/*
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
* and limitations under the License.
*/
package software.amazon.awssdk.services.rds.model;
import java.io.Serializable;
import java.util.Arrays;
import java.util.Collections;
import java.util.List;
import java.util.Objects;
import java.util.Optional;
import java.util.function.BiConsumer;
import java.util.function.Consumer;
import java.util.function.Function;
import software.amazon.awssdk.annotations.Generated;
import software.amazon.awssdk.core.SdkField;
import software.amazon.awssdk.core.SdkPojo;
import software.amazon.awssdk.core.protocol.MarshallLocation;
import software.amazon.awssdk.core.protocol.MarshallingType;
import software.amazon.awssdk.core.traits.LocationTrait;
import software.amazon.awssdk.utils.ToString;
import software.amazon.awssdk.utils.builder.CopyableBuilder;
import software.amazon.awssdk.utils.builder.ToCopyableBuilder;
/**
*
* A single Performance Insights metric query to process. You must provide the metric to the query. If other parameters
* aren't specified, Performance Insights returns all data points for the specified metric. Optionally, you can request
* the data points to be aggregated by dimension group (GroupBy) and return only those data points that
* match your criteria (Filter).
*
*
* Constraints:
*
*
* -
*
* Must be a valid Performance Insights query.
*
*
*
*/
@Generated("software.amazon.awssdk:codegen")
public final class PerformanceInsightsMetricQuery implements SdkPojo, Serializable,
ToCopyableBuilder {
private static final SdkField GROUP_BY_FIELD = SdkField
. builder(MarshallingType.SDK_POJO).memberName("GroupBy")
.getter(getter(PerformanceInsightsMetricQuery::groupBy)).setter(setter(Builder::groupBy))
.constructor(PerformanceInsightsMetricDimensionGroup::builder)
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("GroupBy").build()).build();
private static final SdkField METRIC_FIELD = SdkField. builder(MarshallingType.STRING).memberName("Metric")
.getter(getter(PerformanceInsightsMetricQuery::metric)).setter(setter(Builder::metric))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("Metric").build()).build();
private static final List> SDK_FIELDS = Collections.unmodifiableList(Arrays.asList(GROUP_BY_FIELD, METRIC_FIELD));
private static final long serialVersionUID = 1L;
private final PerformanceInsightsMetricDimensionGroup groupBy;
private final String metric;
private PerformanceInsightsMetricQuery(BuilderImpl builder) {
this.groupBy = builder.groupBy;
this.metric = builder.metric;
}
/**
*
* 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.
*
*
* @return 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.
*/
public final PerformanceInsightsMetricDimensionGroup groupBy() {
return groupBy;
}
/**
*
* The name of a Performance Insights metric to be measured.
*
*
* Valid Values:
*
*
* -
*
* 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 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.
*
*
* @return The name of a Performance Insights metric to be measured.
*
* Valid Values:
*
*
* -
*
* 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 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.
*/
public final String metric() {
return metric;
}
@Override
public Builder toBuilder() {
return new BuilderImpl(this);
}
public static Builder builder() {
return new BuilderImpl();
}
public static Class serializableBuilderClass() {
return BuilderImpl.class;
}
@Override
public final int hashCode() {
int hashCode = 1;
hashCode = 31 * hashCode + Objects.hashCode(groupBy());
hashCode = 31 * hashCode + Objects.hashCode(metric());
return hashCode;
}
@Override
public final boolean equals(Object obj) {
return equalsBySdkFields(obj);
}
@Override
public final boolean equalsBySdkFields(Object obj) {
if (this == obj) {
return true;
}
if (obj == null) {
return false;
}
if (!(obj instanceof PerformanceInsightsMetricQuery)) {
return false;
}
PerformanceInsightsMetricQuery other = (PerformanceInsightsMetricQuery) obj;
return Objects.equals(groupBy(), other.groupBy()) && Objects.equals(metric(), other.metric());
}
/**
* Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be
* redacted from this string using a placeholder value.
*/
@Override
public final String toString() {
return ToString.builder("PerformanceInsightsMetricQuery").add("GroupBy", groupBy()).add("Metric", metric()).build();
}
public final Optional getValueForField(String fieldName, Class clazz) {
switch (fieldName) {
case "GroupBy":
return Optional.ofNullable(clazz.cast(groupBy()));
case "Metric":
return Optional.ofNullable(clazz.cast(metric()));
default:
return Optional.empty();
}
}
@Override
public final List> sdkFields() {
return SDK_FIELDS;
}
private static Function getter(Function g) {
return obj -> g.apply((PerformanceInsightsMetricQuery) obj);
}
private static BiConsumer setter(BiConsumer s) {
return (obj, val) -> s.accept((Builder) obj, val);
}
public interface Builder extends SdkPojo, CopyableBuilder {
/**
*
* 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.
*
*
* @param groupBy
* 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.
* @return Returns a reference to this object so that method calls can be chained together.
*/
Builder groupBy(PerformanceInsightsMetricDimensionGroup groupBy);
/**
*
* 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.
*
* This is a convenience method that creates an instance of the
* {@link PerformanceInsightsMetricDimensionGroup.Builder} avoiding the need to create one manually via
* {@link PerformanceInsightsMetricDimensionGroup#builder()}.
*
*
* When the {@link Consumer} completes, {@link PerformanceInsightsMetricDimensionGroup.Builder#build()} is
* called immediately and its result is passed to {@link #groupBy(PerformanceInsightsMetricDimensionGroup)}.
*
* @param groupBy
* a consumer that will call methods on {@link PerformanceInsightsMetricDimensionGroup.Builder}
* @return Returns a reference to this object so that method calls can be chained together.
* @see #groupBy(PerformanceInsightsMetricDimensionGroup)
*/
default Builder groupBy(Consumer groupBy) {
return groupBy(PerformanceInsightsMetricDimensionGroup.builder().applyMutation(groupBy).build());
}
/**
*
* The name of a Performance Insights metric to be measured.
*
*
* Valid Values:
*
*
* -
*
* 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 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.
*
*
* @param metric
* The name of a Performance Insights metric to be measured.
*
* Valid Values:
*
*
* -
*
* 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 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.
* @return Returns a reference to this object so that method calls can be chained together.
*/
Builder metric(String metric);
}
static final class BuilderImpl implements Builder {
private PerformanceInsightsMetricDimensionGroup groupBy;
private String metric;
private BuilderImpl() {
}
private BuilderImpl(PerformanceInsightsMetricQuery model) {
groupBy(model.groupBy);
metric(model.metric);
}
public final PerformanceInsightsMetricDimensionGroup.Builder getGroupBy() {
return groupBy != null ? groupBy.toBuilder() : null;
}
public final void setGroupBy(PerformanceInsightsMetricDimensionGroup.BuilderImpl groupBy) {
this.groupBy = groupBy != null ? groupBy.build() : null;
}
@Override
public final Builder groupBy(PerformanceInsightsMetricDimensionGroup groupBy) {
this.groupBy = groupBy;
return this;
}
public final String getMetric() {
return metric;
}
public final void setMetric(String metric) {
this.metric = metric;
}
@Override
public final Builder metric(String metric) {
this.metric = metric;
return this;
}
@Override
public PerformanceInsightsMetricQuery build() {
return new PerformanceInsightsMetricQuery(this);
}
@Override
public List> sdkFields() {
return SDK_FIELDS;
}
}
}