Add docs for influx scaler related to influx v3 parameters

content/docs/2.14/scalers/influxdb.md

@@ -15,28 +15,36 @@ triggers:
   - type: influxdb
     metadata:
       serverURL: http://influxdb:8086
-      organizationName: influx-org
+      organizationName: influx-org # Required for Influx v2. Ignored for v3.
       organizationNameFromEnv: INFLUXDB_ORG_NAME # Optional: You can use this instead of `organizationName` parameter. See details in "Parameter List" section
       thresholdValue: '4.4'
       activationThresholdValue: '6.2'
       query: |
         from(bucket: "bucket-of-interest")
         |> range(start: -12h)
         |> filter(fn: (r) => r._measurement == "stat")
+      metricKey: 'mymetric' # Required for Influx v3. Ignored for v2. See details in "Parameter List" section
+      queryType: 'InfluxQL' # Required for Influx v3. Ignored for v2. See details in "Parameter List" section
+      influxVersion: '3' # Optional: Defaults to 2.
+      database: 'some-influx-db' # Required for Influx v3
       authToken: some-auth-token
       authTokenFromEnv: INFLUXDB_AUTH_TOKEN # Optional: You can use this instead of `authToken` parameter. See details in "Parameter List" section
 ```
 
 **Parameter list:**
 
-- `authToken` - Authentication token needed for the InfluxDB client to communicate with an associated server.
+- `activationThresholdValue` - Target value for activating the scaler. Learn more about activation [here](./../concepts/scaling-deployments.md#activating-and-scaling-thresholds).(Default: `0`, Optional, This value can be a float)
 - `authTokenFromEnv` - Defines the authorization token, similar to `authToken`, but reads it from an environment variable on the scale target.
-- `organizationName` - Organization name needed for the client to locate all information contained in that [organization](https://docs.influxdata.com/influxdb/v2.0/organizations/) such as buckets, tasks, etc.
-- `organizationNameFromEnv` - Defines the organization name, similar to `organizationName`, but reads it from an environment variable on the scale target.
+- `authToken` - Authentication token needed for the InfluxDB client to communicate with an associated server.
+- `database` - The database to query. Required if `influxVersion` is set to `3`.
+- `influxVersion` - Version of influx to use, either `2` or `3`. This determines the API client version used to send the query. (Default: `2`). Optional, This value should be a string.
+- `metricKey` - A key used to return the metric value from the query response. Only required for Influx v3. For a `query` of `SELECT mean("mymetric") AS "metric_name" FROM...` use `metricKey: 'metric_name'`.
+- `organizationNameFromEnv` - Defines the organization name, similar to `organizationName`, but reads it from an environment variable on the scale target. Ignored for Influx v3.
+- `organizationName` - Organization name needed for the Influx v2 client to locate all information contained in that [organization](https://docs.influxdata.com/influxdb/v2.0/organizations/) such as buckets, tasks, etc. Ignored for Influx v3.
+- `queryType` - Type of `query` to send. Only used with Influx v3 where it can be `InfluxQL` or `FlightSQL` and the default is FlightSQL. Ignored for Influx v2 where only Flux is supported.
+- `query` - The query that will yield the value for the scaler to compare the `thresholdValue` against.
 - `serverURL` - Holds the url value of the InfluxDB server.
 - `thresholdValue` - Provided by the user. This value can vary from use case to use case depending on the data of interest, and is needed to trigger the scaling in/out depending on what value comes back from the query. (This value can be a float)
-- `activationThresholdValue` - Target value for activating the scaler. Learn more about activation [here](./../concepts/scaling-deployments.md#activating-and-scaling-thresholds).(Default: `0`, Optional, This value can be a float)
-- `query` - Flux query that will yield the value for the scaler to compare the `thresholdValue` against.
 - `unsafeSsl` - Skip certificate validation when connecting over HTTPS. (Values: `true`, `false`, Default: `false`, Optional)
 
 ### Authentication Parameters
@@ -49,7 +57,7 @@ You can authenticate by using an authorization token.
 
 ### Example
 
-Below is an example of how to deploy a scaled object with the `InfluxDB` scale trigger.
+Below is an example of how to deploy a scaled object with the `InfluxDB` v2 scale trigger.
 
 ```yaml
 apiVersion: keda.sh/v1alpha1
@@ -73,3 +81,33 @@ spec:
           |> filter(fn: (r) => r._measurement == "stat")
         authTokenFromEnv: INFLUXDB_AUTH_TOKEN
 ```
+
+### Example for Influx v3
+
+Below is a similar example for Influx v3 using an `InfluxQL` query.
+
+```yaml
+apiVersion: keda.sh/v1alpha1
+kind: ScaledObject
+metadata:
+  name: influxdb-scaledobject
+  namespace: my-project
+spec:
+  scaleTargetRef:
+    name: nginx-worker
+  triggers:
+    - type: influxdb
+      metadata:
+        serverURL: http://influxdb:8086
+        database: 'my-metrics-db'
+        influxVersion: '3'
+        queryType: 'InfluxQL'
+        metricKey: 'level'
+        thresholdValue: '2'
+        activationThresholdValue: '10'
+        query: |
+          SELECT mean("water_level") AS "level" FROM "h2o_feet"
+          GROUP BY time(5m)
+          ORDER BY time DESC LIMIT 1;
+        authTokenFromEnv: INFLUXDB_AUTH_TOKEN
+```