v1beta1

Reference information for metrics.keptn.sh/v1beta1

Packages

metrics.keptn.sh/v1beta1

Package v1beta1 contains API Schema definitions for the metrics v1beta1 API group

Resource Types

Analysis

Analysis is the Schema for the analyses API

Appears in:

Field Description Default Optional
apiVersion string metrics.keptn.sh/v1beta1
kind string Analysis
metadata ObjectMeta Refer to Kubernetes API documentation for fields of metadata. ✓
spec AnalysisSpec ✓
status AnalysisStatus ✓

AnalysisDefinition

AnalysisDefinition is the Schema for the analysisdefinitions APIs

Appears in:

Field Description Default Optional
apiVersion string metrics.keptn.sh/v1beta1
kind string AnalysisDefinition
metadata ObjectMeta Refer to Kubernetes API documentation for fields of metadata. ✓
spec AnalysisDefinitionSpec ✓
status string unused field ✓

AnalysisDefinitionList

AnalysisDefinitionList contains a list of AnalysisDefinition resources

Field Description Default Optional
apiVersion string metrics.keptn.sh/v1beta1
kind string AnalysisDefinitionList
metadata ListMeta Refer to Kubernetes API documentation for fields of metadata. ✓
items AnalysisDefinition array x

AnalysisDefinitionSpec

AnalysisDefinitionSpec defines the desired state of AnalysisDefinition

Appears in:

Field Description Default Optional
objectives Objective array Objectives defines a list of objectives to evaluate for an analysis ✓
totalScore TotalScore TotalScore defines the required score for an analysis to be successful x

AnalysisList

AnalysisList contains a list of Analysis resources

Field Description Default Optional
apiVersion string metrics.keptn.sh/v1beta1
kind string AnalysisList
metadata ListMeta Refer to Kubernetes API documentation for fields of metadata. ✓
items Analysis array x

AnalysisSpec

AnalysisSpec defines the desired state of Analysis

Appears in:

Field Description Default Optional
timeframe Timeframe Timeframe specifies the range for the corresponding query in the AnalysisValueTemplate. Please note that either a combination of ‘from’ and ’to’ or the ‘recent’ property may be set. If neither is set, the Analysis can not be added to the cluster. x
args object (keys:string, values:string) Args corresponds to a map of key/value pairs that can be used to substitute placeholders in the AnalysisValueTemplate query. i.e. for args foo:bar the query could be “query:percentile(95)?scope=tag(my_foo_label:{{.foo}})”. ✓
analysisDefinition ObjectReference AnalysisDefinition refers to the AnalysisDefinition, a CRD that stores the AnalysisValuesTemplates x

AnalysisState

Underlying type: string

AnalysisState represents the state of the analysis

Appears in:

AnalysisStatus

AnalysisStatus stores the status of the overall analysis returns also pass or warnings

Appears in:

Field Description Default Optional
timeframe Timeframe Timeframe describes the time frame which is evaluated by the Analysis x
raw string Raw contains the raw result of the SLO computation ✓
pass boolean Pass returns whether the SLO is satisfied ✓
warning boolean Warning returns whether the analysis returned a warning ✓
state string State describes the current state of the Analysis (Pending/Progressing/Completed) x
storedValues object (keys:string, values:ProviderResult) StoredValues contains all analysis values that have already been retrieved successfully ✓

AnalysisValueTemplate

AnalysisValueTemplate is the Schema for the analysisvaluetemplates API

Appears in:

Field Description Default Optional
apiVersion string metrics.keptn.sh/v1beta1
kind string AnalysisValueTemplate
metadata ObjectMeta Refer to Kubernetes API documentation for fields of metadata. ✓
spec AnalysisValueTemplateSpec Spec contains the specification for the AnalysisValueTemplate ✓
status string unused field ✓

AnalysisValueTemplateList

AnalysisValueTemplateList contains a list of AnalysisValueTemplate resources

Field Description Default Optional
apiVersion string metrics.keptn.sh/v1beta1
kind string AnalysisValueTemplateList
metadata ListMeta Refer to Kubernetes API documentation for fields of metadata. ✓
items AnalysisValueTemplate array x

AnalysisValueTemplateSpec

AnalysisValueTemplateSpec defines the desired state of AnalysisValueTemplate

Appears in:

Field Description Default Optional
provider ObjectReference Provider refers to the KeptnMetricsProvider which should be used to retrieve the data x
query string Query represents the query to be run. It can include placeholders that are defined using the go template syntax. More info on go templating - https://pkg.go.dev/text/template x

IntervalResult

Appears in:

Field Description Default Optional
value string Value represents the resulting value x
range RangeSpec Range represents the time range for which this data was queried x
lastUpdated Time LastUpdated represents the time when the status data was last updated x
errMsg string ErrMsg represents the error details when the query could not be evaluated ✓

KeptnMetric

KeptnMetric is the Schema for the keptnmetrics API

Appears in:

Field Description Default Optional
apiVersion string metrics.keptn.sh/v1beta1
kind string KeptnMetric
metadata ObjectMeta Refer to Kubernetes API documentation for fields of metadata. ✓
spec KeptnMetricSpec ✓
status KeptnMetricStatus ✓

KeptnMetricList

KeptnMetricList contains a list of KeptnMetric resources

Field Description Default Optional
apiVersion string metrics.keptn.sh/v1beta1
kind string KeptnMetricList
metadata ListMeta Refer to Kubernetes API documentation for fields of metadata. ✓
items KeptnMetric array x

KeptnMetricSpec

KeptnMetricSpec defines the desired state of KeptnMetric

Appears in:

Field Description Default Optional
provider ProviderRef Provider represents the provider object x
query string Query represents the query to be run x
fetchIntervalSeconds integer FetchIntervalSeconds represents the update frequency in seconds that is used to update the metric x
range RangeSpec Range represents the time range for which data is to be queried ✓

KeptnMetricStatus

KeptnMetricStatus defines the observed state of KeptnMetric

Appears in:

Field Description Default Optional
value string Value represents the resulting value ✓
rawValue integer array RawValue represents the resulting value in raw format ✓
lastUpdated Time LastUpdated represents the time when the status data was last updated ✓
errMsg string ErrMsg represents the error details when the query could not be evaluated ✓
intervalResults IntervalResult array IntervalResults contain a slice of all the interval results ✓

KeptnMetricsProvider

KeptnMetricsProvider is the Schema for the keptnmetricsproviders API

Appears in:

Field Description Default Optional
apiVersion string metrics.keptn.sh/v1beta1
kind string KeptnMetricsProvider
metadata ObjectMeta Refer to Kubernetes API documentation for fields of metadata. ✓
spec KeptnMetricsProviderSpec ✓
status string unused field ✓

KeptnMetricsProviderList

KeptnMetricsProviderList contains a list of KeptnMetricsProvider resources

Field Description Default Optional
apiVersion string metrics.keptn.sh/v1beta1
kind string KeptnMetricsProviderList
metadata ListMeta Refer to Kubernetes API documentation for fields of metadata. ✓
items KeptnMetricsProvider array x

KeptnMetricsProviderSpec

KeptnMetricsProviderSpec defines the desired state of KeptnMetricsProvider

Appears in:

Field Description Default Optional
type string Type represents the provider type. This can be one of prometheus, dynatrace, datadog, dql. x
targetServer string TargetServer defines URL (including port and protocol) at which the metrics provider is reachable. x
secretKeyRef SecretKeySelector SecretKeyRef defines an optional secret for access credentials to the metrics provider. ✓

ObjectReference

Appears in:

Field Description Default Optional
name string Name defines the name of the referenced object x
namespace string Namespace defines the namespace of the referenced object ✓

Objective

Objective defines an objective for analysis

Appears in:

Field Description Default Optional
analysisValueTemplateRef ObjectReference AnalysisValueTemplateRef refers to the appropriate AnalysisValueTemplate x
target Target Target defines failure or warning criteria ✓
weight integer Weight can be used to emphasize the importance of one Objective over the others 1 ✓
keyObjective boolean KeyObjective defines whether the whole analysis fails when this objective’s target is not met false ✓

Operator

Operator specifies the supported operators for value comparisons

Appears in:

Field Description Default Optional
lessThanOrEqual OperatorValue LessThanOrEqual represents ‘<=’ operator ✓
lessThan OperatorValue LessThan represents ‘<’ operator ✓
greaterThan OperatorValue GreaterThan represents ‘>’ operator ✓
greaterThanOrEqual OperatorValue GreaterThanOrEqual represents ‘>=’ operator ✓
equalTo OperatorValue EqualTo represents ‘==’ operator ✓
inRange RangeValue InRange represents operator checking the value is inclusively in the defined range, e.g. 2 <= x <= 5 ✓
notInRange RangeValue NotInRange represents operator checking the value is exclusively out of the defined range, e.g. x < 2 AND x > 5 ✓

OperatorValue

OperatorValue represents the value to which the result is compared

Appears in:

Field Description Default Optional
fixedValue Quantity FixedValue defines the value for comparison x

ProviderRef

ProviderRef represents the provider object

Appears in:

Field Description Default Optional
name string Name of the provider x

ProviderResult

ProviderResult stores reference of already collected provider query associated to its objective template

Appears in:

Field Description Default Optional
objectiveReference ObjectReference Objective store reference to corresponding objective template ✓
query string Query represents the executed query ✓
value string Value is the value the provider returned ✓
errMsg string ErrMsg stores any possible error at retrieval time ✓

RangeSpec

RangeSpec defines the time range for which data is to be queried

Appears in:

Field Description Default Optional
interval string Interval specifies the duration of the time interval for the data query 5m ✓
step string Step represents the query resolution step width for the data query ✓
aggregation string Aggregation defines the type of aggregation function to be applied on the data. Accepted values: p90, p95, p99, max, min, avg, median ✓
storedResults integer StoredResults indicates the upper limit of how many past results should be stored in the status of a KeptnMetric ✓

RangeValue

RangeValue represents a range which the value should fit

Appears in:

Field Description Default Optional
lowBound Quantity LowBound defines the lower bound of the range x
highBound Quantity HighBound defines the higher bound of the range x

Target

Target defines the failure and warning criteria

Appears in:

Field Description Default Optional
failure Operator Failure defines limits up to which an analysis fails ✓
warning Operator Warning defines limits where the result does not pass or fail ✓

Timeframe

Appears in:

Field Description Default Optional
from Time From is the time of start for the query. This field follows RFC3339 time format ✓
to Time To is the time of end for the query. This field follows RFC3339 time format ✓
recent Duration Recent describes a recent timeframe using a duration string. E.g. Setting this to ‘5m’ provides an Analysis for the last five minutes ✓

TotalScore

TotalScore defines the required score for an analysis to be successful

Appears in:

Field Description Default Optional
passPercentage integer PassPercentage defines the threshold to reach for an analysis to pass x
warningPercentage integer WarningPercentage defines the threshold to reach for an analysis to pass with a ‘warning’ status x
Last modified 2023-11-27: chore: update to crd generator to v0.0.10 (#2329) (525ae037)