> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/resilience-testing/chaos-engineering/use-chaos-engineering/probes/prometheus-probes/configure-prom-probe.md).

# Configure Prometheus Probe

Configure Prometheus probe

* [What is a Resilience Probe?](/resilience-testing/chaos-engineering/use-chaos-engineering/probes/index.md#what-is-a-resilience-probe)
* [Prometheus Probe](/resilience-testing/chaos-engineering/use-chaos-engineering/probes/prometheus-probes/index.md)

## Configuration <a href="#configuration" id="configuration"></a>

1. Go to **Chaos Engineering** module and select **Resilience Probes**. Select **New Probe**.

   ![navigate to module](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-d60edbf3a465b53fd70f85a6fd772179929dcaaf%2Fnavigate-1.png?alt=media)
2. Select infrastructure type as **Kubernetes** and chaos probe as **Prometheus**.

   ![prometheus probe](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-554003bea77c9af2d9134cad2bfd570e779ce609%2Fselect-prom.png?alt=media)
3. Provide the name, and click **Configure Details**.

   ![configure details](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-6829784882e670edf83079469926fd68f82f7954%2Fname-1.png?alt=media)
4. Based on your application's requirements, provide values for the following parameters.

* **Prometheus Endpoint**: It is the target HTTP/HTTPS endpoint that the probe will send requests to.

  ![](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-4a55975c9114e5c39c6396b08adf0a1c6cea58e5%2Fdetails-2.png?alt=media)

5. **Authorization** section has the following fields:

   * **Type**: Type of HTTP request to be performed. Supports `GET` and `POST`.
   * **Credentials**: Authentication credentials (username and password) required to access the target URL/endpoint. This field is mutually exclusive with **Credentials file** field.
   * **Credentials file**: Path of the file that contains authentication credentials to access the HTTP endpoint. This field is mutually exclusive with **Credentials** field.

   Go to [Authorization](/resilience-testing/chaos-engineering/use-chaos-engineering/probes/prometheus-probes/index.md#authentication) for more information.

   **TLS Config** has the following fields:

   * **CA file**: Path of the file to validate the custom certificates for TLS of the target URL.
   * **Cert file**: Path of the file to the client certificate required for mTLS.
   * **Key file**: Path of the file to the client key required for mTLS.
   * **Insecure Skip Verify**: If enabled, the probe bypasses the SSL/TLS certificate verification, allowing requests to proceed even if the certificate is invalid or self-signed.

   Go to [TLS](/resilience-testing/chaos-engineering/use-chaos-engineering/probes/prometheus-probes/index.md#tls) for more information.

   ![](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-e8d19b702861f01c4f3d58e5ace788be471a4b7c%2Fauth-3.png?alt=media) ![](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-3f8231752aef3321cdce743c1e598861226406fb%2Fauth-3-1.png?alt=media)
6. Provide the **Prometheus Query** (**Query** or **Query Path** depending on your usage).

   * **Query**: The PromQL query used with the probe to fetch the desired Prometheus metrics. Ensure that the strings inside the query are enclosed within backslash ("/"). This field is mutually exclusive with **Query Path** field.
   * **Query Path**: Path of the file where PromQL query is present. This field is mutually exclusive with **Query** field.

   Go to [Schema](/resilience-testing/chaos-engineering/use-chaos-engineering/probes/prometheus-probes/index.md#schema) for more information.

   ![](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-39fb2ec4eafe0bae850e49b9a0a15384169464d2%2Fquery-4.png?alt=media)
7. Specify the data comparison fields, and click **Configure Properties**.

   The data returned using the PromQL **Query** or **Query Path** is compared to the following fields:

   * **Type**: Type of data compared with result of Prometheus query. Accepts only `float` data type.
   * **Comparison Criteria**: The criteria (`>=`, `<=`, `==`, `<`, `>`, `!=`, and so on) based on which the **value** and the result of Prometheus query are compared.
   * **Value**: The value with which the result of Prometheus query is compared

   Go to [Comparator](/resilience-testing/chaos-engineering/use-chaos-engineering/probes/prometheus-probes/index.md#comparator) for more information.

   ![](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-990f605c1cbc2d2c3ebc964892109bcc8d7d0513%2Fcomparison-5.png?alt=media)
8. Specify general probe properties such as timeout, interval, and so on. Click **Create Probe**.

* **Timeout**: Time limit for the probe to execute the check and return the expected output.
* **Interval**: Duration for which the probe waits between subsequent attempts.
* **Attempt**: Number of times a check is executed upon failure in the previous attempts before declaring the probe status as `FAILED`.
* **Polling Interval**: Time interval for which `continuous` and `onchaos` probe modes should wait after each iteration.
* **Initial Delay**: Duration to wait before the probe begins execution.
* **Verbosity**: Level of detail to include in the logs generated during the execution of the probe. Choose between `info` (essential logs, probe status are printed) and `debug` (in-depth logs, timestamps, and execution logs are printed) mode.
* **Stop on Failure (Optional)**: Enable it to continue or disable it to stop the experiment execution after the probe fails. Disabled by default.

Go to [Run Properties](/resilience-testing/chaos-engineering/use-chaos-engineering/probes/prometheus-probes/index.md#run-properties) for more information.

![](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-11338c5e0692c0fda9db5f08b3c5c6a34ae865a1%2Fproperties-6.png?alt=media)

{% @harness-feedback/feedback %}