Warning
You are currently viewing v"2.15" of the documentation and it is not the latest. For the most recent documentation, kindly click here.
This specification describes the metrics-api
trigger that scales based on a metric value provided by an API.
This scaler allows users to utilize any existing APIs as a metric provider.
Here is an example of trigger configuration using metrics-api scaler:
triggers:
- type: metrics-api
metadata:
targetValue: "8.8"
format: "json"
activationTargetValue: "3.8"
url: "http://api:3232/api/v1/stats"
valueLocation: "components.worker.tasks"
Parameter list:
url
- Full URL of the API operation to call to get the metric value (eg. http://app:1317/api/v1/stats
).
format
- One of the following formats: json
, xml
, yaml
, prometheus
. (Default: json
, Optional)
valueLocation
- The location of the metric value in the response payload. The value is format specific.
json
- GJSON path notation to refer to the field in the payload containing the metric value.yaml
, xml
, prometheus
- implemented as dot-separated path algorithm for value parsing.
{foo: {bar: 42}}
- foo.bar
will return 42{foo: [{bar: 42}]}
- foo.0.bar
will return 42yaml
, xml
and prometheus
formats.targetValue
- Target value to scale on. When the metric provided by the API is equal or higher to this value, KEDA will start scaling out. When the metric is 0 or less, KEDA will scale down to 0. (This value can be a float)
activationTargetValue
- Target value for activating the scaler. Learn more about activation here.(Default: 0
, Optional, This value can be a float)
unsafeSsl
- Skip certificate validation when connecting over HTTPS. (Values: true
, false
, Default: false
, Optional)
Metrics Scaler API supported four types of authentication - API Key based authentication, basic authentication, TLS authentication, and Bearer authentication.
You can use TriggerAuthentication
CRD to configure the authentication. Specify authMode
and other trigger parameters
along with secret credentials in TriggerAuthentication
as mentioned below:
API Key based authentication:
authMode
: It must be set to apiKey
in case of API key Authentication. Specify this in trigger configuration.method
- This specifies the possible methods API Key based authentication supports. Possible values are header
and query
. header
is the default method. Specify this in trigger configuration.keyParamName
- This is either header key or query param used for passing apikey. Default header is X-API-KEY
and default query param is api_key
. Specify this in trigger configuration. If your implementation has different key, please specify it here.apiKey
- API Key needed for authentication.Basic authentication:
authMode
- It must be set to basic
in case of Basic Authentication. Specify this in trigger configuration.username
- Provide the username to be used for basic authentication.password
- Provide the password to be used for authentication. (Optional)TLS authentication:
authMode
- It must be set to tls
in case of TLS Authentication. Specify this in trigger configuration.ca
- Certificate authority file for TLS client authentication.cert
- Certificate for client authentication.key
- Key for client authentication. (Optional)Bearer authentication:
authMode
- It must be set to bearer
in case of Bearer Authentication. Specify this in trigger configuration.token
- Token that should be placed in the Authorization
header. The header will be Authorization: Bearer {token}
.Here is a full example of scaled object definition using Metric API trigger:
apiVersion: keda.sh/v1alpha1
kind: ScaledObject
metadata:
name: http-scaledobject
namespace: keda
labels:
deploymentName: dummy
spec:
maxReplicaCount: 12
scaleTargetRef:
name: dummy
triggers:
- type: metrics-api
metadata:
targetValue: "7"
url: "http://api:3232/components/stats"
valueLocation: 'components.worker.tasks'
When checking current metric Metrics API scaler sends GET request to provided url
and then uses valueLocation
to access the value in response’s payload.
The above example expects that the API endpoint will return response similar to this one:
{
"components": {
"worker": {
"tasks": 12,
...
},
...
},
...
}
Assuming such response, Metrics API trigger will figure out that current metric value is 12.
💡 **NOTE:**The value of the metric can either be an integral unquoted json number type (e.g. 123). Or a quantity (e.g. “123”, “1.23”, “10Mi”).
Here is an example of a metric scaler with API Key based authentication,
apiVersion: v1
kind: Secret
metadata:
name: keda-metric-api-secret
namespace: default
data:
apiKey: "APIKEY"
---
apiVersion: keda.sh/v1alpha1
kind: TriggerAuthentication
metadata:
name: keda-metric-api-creds
namespace: default
spec:
secretTargetRef:
- parameter: apiKey
name: keda-metric-api-secret
key: apiKey
---
apiVersion: keda.sh/v1alpha1
kind: ScaledObject
metadata:
name: http-scaledobject
namespace: keda
labels:
deploymentName: dummy
spec:
maxReplicaCount: 12
scaleTargetRef:
name: dummy
triggers:
- type: metrics-api
metadata:
targetValue: "7"
url: "http://api:3232/components/stats"
valueLocation: 'components.worker.tasks'
authMode: "apiKey"
method: "query"
keyParamName: "QUERY_KEY"
authenticationRef:
name: keda-metric-api-creds
Here is an example of a metric scaler with Bearer Authentication, define the Secret
and TriggerAuthentication
as follows
apiVersion: v1
kind: Secret
metadata:
name: keda-metric-api-secret
namespace: default
data:
token: "PlaceYourTokenHere"
---
apiVersion: keda.sh/v1alpha1
kind: TriggerAuthentication
metadata:
name: keda-metric-api-creds
namespace: default
spec:
secretTargetRef:
- parameter: token
name: keda-metric-api-secret
key: token
---
apiVersion: keda.sh/v1alpha1
kind: ScaledObject
metadata:
name: http-scaledobject
namespace: keda
labels:
deploymentName: dummy
spec:
maxReplicaCount: 12
scaleTargetRef:
name: dummy
triggers:
- type: metrics-api
metadata:
targetValue: "7"
url: "http://api:3232/components/stats"
valueLocation: 'components.worker.tasks'
authMode: "bearer"
authenticationRef:
name: keda-metric-api-creds
Here is an example of a metric scaler with Basic Authentication, define the Secret
and TriggerAuthentication
as follows
apiVersion: v1
kind: Secret
metadata:
name: keda-metric-api-secret
namespace: default
data:
username: "username"
password: "password"
---
apiVersion: keda.sh/v1alpha1
kind: TriggerAuthentication
metadata:
name: keda-metric-api-creds
namespace: default
spec:
secretTargetRef:
- parameter: username
name: keda-metric-api-secret
key: username
- parameter: password
name: keda-metric-api-secret
key: password
---
apiVersion: keda.sh/v1alpha1
kind: ScaledObject
metadata:
name: http-scaledobject
namespace: keda
labels:
deploymentName: dummy
spec:
maxReplicaCount: 12
scaleTargetRef:
name: dummy
triggers:
- type: metrics-api
metadata:
targetValue: "7"
url: "http://api:3232/components/stats"
valueLocation: 'components.worker.tasks'
authMode: "basic"
authenticationRef:
name: keda-metric-api-creds
Here is an example of a metric scaler with TLS Authentication, define the Secret
and TriggerAuthentication
as follows
apiVersion: v1
kind: Secret
metadata:
name: keda-metric-api-secret
namespace: default
data:
cert: "cert"
key: "key"
ca: "ca"
---
apiVersion: keda.sh/v1alpha1
kind: TriggerAuthentication
metadata:
name: keda-metric-api-creds
namespace: default
spec:
secretTargetRef:
- parameter: cert
name: keda-metric-api-secret
key: cert
- parameter: key
name: keda-metric-api-secret
key: key
- parameter: ca
name: keda-metric-api-secret
key: ca
---
apiVersion: keda.sh/v1alpha1
kind: ScaledObject
metadata:
name: http-scaledobject
namespace: keda
labels:
deploymentName: dummy
spec:
maxReplicaCount: 12
scaleTargetRef:
name: dummy
triggers:
- type: metrics-api
metadata:
targetValue: "7"
url: "http://api:3232/components/stats"
valueLocation: 'components.worker.tasks'
authMode: "tls"
authenticationRef:
name: keda-metric-api-creds