---
title: Configure Synthetics settings
description: Configure Synthetics settings including alerting rules, private locations, global parameters, data retention, project API keys, and cross-cluster search settings.
url: https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7571/solutions/observability/synthetics/configure-settings
products:
- Elastic Cloud Serverless
- Elastic Observability
applies_to:
- Elastic Cloud Serverless: Generally available
- Elastic Stack: Generally available
---
# Configure Synthetics settings
There are several Synthetics settings you can adjust in Observability.
## Alerting
Alerting enables you to detect complex conditions using **rules** across Observability and send a notification using **connectors**.
When you create a new synthetic monitor, Synthetics applies new default rules to the monitor. To edit the default rules:
1. Click **Alerts** in the global header.
2. Select a rule to open a panel where you can edit the rule’s configuration:
- **Monitor status rule** for receiving notifications for errors and outages
- **TLS certificate rule** for receiving notifications when one or more of your HTTP or TCP lightweight monitors has a TLS certificate expiring within a specified threshold or when it exceeds an age limit
However, the automatically created Synthetics internal alert is intentionally preconfigured, and some configuration options can’t be changed. For example, you can’t change how often it checks the rule.
If you need specific alerting behavior, set up a different rule. To view all existing rules or create a new rule:
1. Click **Alerts** in the global header.
2. Click **Manage rules** to go to the *Rules* page.
On the *Rules* page, you can manage the default synthetics rules including snoozing rules, disabling rules, deleting rules, and more.
You can turn on and turn off default alerts for individual monitors in a few ways:
- In the Synthetics UI when you [create a monitor](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7571/solutions/observability/synthetics/create-monitors-ui).
- In the Synthetics UI *after* a monitor is already created, on the **Monitors** page or on the **Edit monitor** page for the monitor.
- In Synthetics projects when [configuring a lightweight monitor](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7571/solutions/observability/synthetics/configure-lightweight-monitors).
In the **Alerting** tab on the **Monitor** Settings page, you can:
- Turn on or turn off default rules.
- Add and configure connectors. For available connectors, refer to [Action types](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7571/solutions/observability/incident-management/create-an-apm-anomaly-rule).
- Set up email alerts, if you are running in Elastic Cloud. An SMTP connector is automatically configured.
## Private Locations
Private Locations allow you to run monitors from your own premises.
In the **Private Locations** tab, you can add and manage Private Locations. After you [Set up Fleet Server and Elastic Agent](/elastic/docs-content/pull/7571/solutions/observability/synthetics/monitor-resources-on-private-networks#synthetics-private-location-fleet-agent) and [Connect to the Elastic Stack or your serverless Observability project](/elastic/docs-content/pull/7571/solutions/observability/synthetics/monitor-resources-on-private-networks#synthetics-private-location-connect), this is where you add the Private Location so you can specify it as the location for a monitor created using the Synthetics UI or a Synthetics project.
Elastic Stack: Generally available since 9.4 Elastic Cloud Serverless: Generally available When a private location has monitors with broken Fleet integrations, a badge showing the count of unhealthy monitors appears in the location's row. Click the badge to open a popover listing the affected monitors. From the popover, use **Reset monitors** to bulk-reset all monitors at that location that have a `missing_package_policy` status. Monitors with other failure types are excluded and must be resolved manually. Refer to [Monitor integration health](/elastic/docs-content/pull/7571/solutions/observability/synthetics/monitor-resources-on-private-networks#synthetics-private-location-health) for details on failure types and remediation steps.
## Global parameters
Global parameters can be defined once and used across the configuration of lightweight and browser-based monitors.
In the **Global parameters** tab, you can define variables and parameters. This is one of several methods you can use to define variables and parameters. To learn more about the other methods and which methods take precedence over others, see [Work with params and secrets](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7571/solutions/observability/synthetics/work-with-params-secrets).
## Data retention
When you set up a synthetic monitor, data from the monitor is saved in [Elasticsearch data streams](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7571/manage-data/data-store/data-streams), an append-only structure in Elasticsearch. You can customize how long synthetics data is stored by creating your own index lifecycle policy and attaching it to the relevant custom Component Template.
In the **Data retention** tab, use the links to jump to the relevant policy for each data stream. Learn more about the data included in each data stream in [Manage data retention](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7571/solutions/observability/synthetics/manage-data-retention).
## Project API keys
Project API keys are used to push project monitors remotely from a CLI or CD pipeline.
In the **Project API keys** tab, you can generate project API keys to use with your projects. Learn more about using API keys in [Use Project monitors](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7571/solutions/observability/synthetics/create-monitors-with-projects).
**In an Elastic Stack deployment**, to create a Project API key you must be logged into Kibana as a user with the privileges described in [Writer role](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7571/solutions/observability/synthetics/writer-role).In a serverless project, to create a Project API key you must be logged in as a user with [Editor](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/7571/solutions/observability/synthetics/grant-access-to-secured-resources) access.
- The **Elastic managed locations enabled** toggle controls whether your Synthetics monitors are permitted to run from Elastic's globally distributed, cloud-hosted testing infrastructure. If enabled, the key can push monitors to both Elastic-managed and private locations. If disabled, the key is restricted to private locations only.
- The **Spaces** menu allows you to select the space where your API keys are available.
## Remote clusters
- Elastic Stack: Planned
In the **Remote clusters** tab, you can configure cross-cluster search (CCS) settings so that Synthetics can include monitor data from remote Elasticsearch clusters alongside your local monitors.
These settings apply to one or more Kibana spaces. Changes you make here affect all spaces that have access to these settings.
### Source settings
Use the **Use all remote clusters** toggle to turn on or turn off cross-cluster search for Synthetics. When enabled, monitors from remote clusters appear alongside local monitors in the Synthetics UI.
### Remote clusters
When **Use all remote clusters** is disabled, use the **Select remote clusters** combo box to select which remote clusters Synthetics queries. Each cluster is shown with a connected or disconnected status indicator.
To configure remote clusters, go to **Stack Management → Remote Clusters**.
### Spaces with access
Use the **Spaces** combo box to control which Kibana spaces these CCS settings apply to. You can select individual spaces, multiple spaces, or **All spaces** to share the settings across your entire deployment. Removing a space from the selection hides these settings in that space.
If you leave the field empty, the current sharing configuration remains unchanged.
## Advanced
- Elastic Cloud Serverless: Generally available
- Elastic Stack: Generally available since 9.4
In the **Advanced** tab, you can configure advanced settings for your Synthetics deployment.
### Maintenance windows sync interval
Private location monitors are periodically synced to apply active maintenance window changes. The **Maintenance windows sync interval** setting controls how frequently this sync occurs.
Use the **Sync interval (minutes)** field to set the interval. The default is 5 minutes, and valid values range from 5 to 1440 minutes. When you apply a new interval, an immediate sync is triggered so the change takes effect right away.
When a maintenance window becomes active, a callout in the Synthetics UI displays the estimated delay for applying changes to private location monitors: *"It may take up to X minutes for maintenance window changes to be applied to private location monitors,"* where X equals the configured sync interval. Click **Sync now** in the callout to trigger an immediate sync without waiting for the interval.
A separate callout appears when maintenance windows are modified or deleted but changes have not yet propagated to your private location monitors.