v1alpha3
Packages
metrics.keptn.sh/v1alpha3
Package v1alpha3 contains API Schema definitions for the metrics v1alpha3 API group
Resource Types
- Analysis
- AnalysisDefinition
- AnalysisDefinitionList
- AnalysisList
- AnalysisValueTemplate
- AnalysisValueTemplateList
- KeptnMetric
- KeptnMetricList
- KeptnMetricsProvider
- KeptnMetricsProviderList
Analysis
Analysis is the Schema for the analyses API
Appears in:
Field | Description |
---|---|
apiVersion string |
metrics.keptn.sh/v1alpha3 |
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 |
---|---|
apiVersion string |
metrics.keptn.sh/v1alpha3 |
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
Field | Description |
---|---|
apiVersion string |
metrics.keptn.sh/v1alpha3 |
kind string |
AnalysisDefinitionList |
metadata ListMeta |
Refer to Kubernetes API documentation for fields of metadata . |
items AnalysisDefinition array |
AnalysisDefinitionSpec
AnalysisDefinitionSpec defines the desired state of AnalysisDefinition
Appears in:
Field | Description |
---|---|
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 |
AnalysisList
AnalysisList contains a list of Analysis
Field | Description |
---|---|
apiVersion string |
metrics.keptn.sh/v1alpha3 |
kind string |
AnalysisList |
metadata ListMeta |
Refer to Kubernetes API documentation for fields of metadata . |
items Analysis array |
AnalysisSpec
AnalysisSpec defines the desired state of Analysis
Appears in:
Field | Description |
---|---|
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. |
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 |
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 |
---|---|
timeframe Timeframe |
Timeframe describes the time frame which is evaluated by the Analysis |
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 AnalysisState |
State describes the current state of the Analysis (Pending/Progressing/Completed) |
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 |
---|---|
apiVersion string |
metrics.keptn.sh/v1alpha3 |
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
Field | Description |
---|---|
apiVersion string |
metrics.keptn.sh/v1alpha3 |
kind string |
AnalysisValueTemplateList |
metadata ListMeta |
Refer to Kubernetes API documentation for fields of metadata . |
items AnalysisValueTemplate array |
AnalysisValueTemplateSpec
AnalysisValueTemplateSpec defines the desired state of AnalysisValueTemplate
Appears in:
Field | Description |
---|---|
provider ObjectReference |
Provider refers to the KeptnMetricsProvider which should be used to retrieve the data |
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 |
IntervalResult
Appears in:
Field | Description |
---|---|
value string |
Value represents the resulting value |
range RangeSpec |
Range represents the time range for which this data was queried |
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 |
KeptnMetric
KeptnMetric is the Schema for the keptnmetrics API
Appears in:
Field | Description |
---|---|
apiVersion string |
metrics.keptn.sh/v1alpha3 |
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
Field | Description |
---|---|
apiVersion string |
metrics.keptn.sh/v1alpha3 |
kind string |
KeptnMetricList |
metadata ListMeta |
Refer to Kubernetes API documentation for fields of metadata . |
items KeptnMetric array |
KeptnMetricSpec
KeptnMetricSpec defines the desired state of KeptnMetric
Appears in:
Field | Description |
---|---|
provider ProviderRef |
Provider represents the provider object |
query string |
Query represents the query to be run |
fetchIntervalSeconds integer |
FetchIntervalSeconds represents the update frequency in seconds that is used to update the metric |
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 |
---|---|
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 |
---|---|
apiVersion string |
metrics.keptn.sh/v1alpha3 |
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
Field | Description |
---|---|
apiVersion string |
metrics.keptn.sh/v1alpha3 |
kind string |
KeptnMetricsProviderList |
metadata ListMeta |
Refer to Kubernetes API documentation for fields of metadata . |
items KeptnMetricsProvider array |
KeptnMetricsProviderSpec
KeptnMetricsProviderSpec defines the desired state of KeptnMetricsProvider
Appears in:
Field | Description |
---|---|
type string |
Type represents the provider type. This can be one of prometheus, dynatrace, datadog, dql. |
targetServer string |
TargetServer defined the URL at which the metrics provider is reachable with included port and protocol. |
secretKeyRef SecretKeySelector |
SecretKeyRef defines an optional secret for access credentials to the metrics provider. |
ObjectReference
Appears in:
Field | Description |
---|---|
name string |
Name defines the name of the referenced object |
namespace string |
Namespace defines the namespace of the referenced object |
Objective
Objective defines an objective for analysis
Appears in:
Field | Description |
---|---|
analysisValueTemplateRef ObjectReference |
AnalysisValueTemplateRef refers to the appropriate AnalysisValueTemplate |
target Target |
Target defines failure or warning criteria |
weight integer |
Weight can be used to emphasize the importance of one Objective over the others |
keyObjective boolean |
KeyObjective defines whether the whole analysis fails when this objective’s target is not met |
Operator
Operator specifies the supported operators for value comparisons
Appears in:
Field | Description |
---|---|
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 |
---|---|
fixedValue Quantity |
FixedValue defines the value for comparison |
ProviderRef
ProviderRef represents the provider object
Appears in:
Field | Description |
---|---|
name string |
Name of the provider |
ProviderResult
ProviderResult stores reference of already collected provider query associated to its objective template
Appears in:
Field | Description |
---|---|
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 |
---|---|
interval string |
Interval specifies the duration of the time interval for the data query |
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 |
---|---|
lowBound Quantity |
LowBound defines the lower bound of the range |
highBound Quantity |
HighBound defines the higher bound of the range |
Target
Target defines the failure and warning criteria
Appears in:
Field | Description |
---|---|
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 |
---|---|
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 |
---|---|
passPercentage integer |
PassPercentage defines the threshold to reach for an analysis to pass |
warningPercentage integer |
WarningPercentage defines the threshold to reach for an analysis to pass with a ‘warning’ status |