diff --git a/docs/alerting/api.md b/docs/alerting/api.md index 98b754e3..eb0e8364 100644 --- a/docs/alerting/api.md +++ b/docs/alerting/api.md @@ -24,7 +24,7 @@ Use the alerting API to programmatically manage monitors and alerts. #### Request ```json -POST _opensearch/_alerting/monitors +POST _plugins/_alerting/monitors { "type": "monitor", "name": "test-monitor", @@ -252,7 +252,7 @@ When you update a monitor, include the current version number as a parameter. Op #### Request ```json -PUT _opensearch/_alerting/monitors/ +PUT _plugins/_alerting/monitors/ { "type": "monitor", "name": "test-monitor", @@ -372,7 +372,7 @@ PUT _opensearch/_alerting/monitors/ #### Request ``` -GET _opensearch/_alerting/monitors/ +GET _plugins/_alerting/monitors/ ``` #### Sample response @@ -439,15 +439,15 @@ GET _opensearch/_alerting/monitors/ ## Monitor stats -Returns statistics about the alerting feature. Use `_opensearch/_alerting/stats` to find node IDs and metrics. Then you can drill down using those values. +Returns statistics about the alerting feature. Use `_plugins/_alerting/stats` to find node IDs and metrics. Then you can drill down using those values. #### Request ```json -GET _opensearch/_alerting/stats -GET _opensearch/_alerting/stats/ -GET _opensearch/_alerting//stats -GET _opensearch/_alerting//stats/ +GET _plugins/_alerting/stats +GET _plugins/_alerting/stats/ +GET _plugins/_alerting//stats +GET _plugins/_alerting//stats/ ``` #### Sample response @@ -631,7 +631,7 @@ GET _opensearch/_alerting//stats/ #### Request ``` -DELETE _opensearch/_alerting/monitors/ +DELETE _plugins/_alerting/monitors/ ``` #### Sample response @@ -662,7 +662,7 @@ DELETE _opensearch/_alerting/monitors/ #### Request ```json -GET _opensearch/_alerting/monitors/_search +GET _plugins/_alerting/monitors/_search { "query": { "match" : { @@ -762,7 +762,7 @@ You can add the optional `?dryrun=true` parameter to the URL to show the results #### Request ```json -POST _opensearch/_alerting/monitors//_execute +POST _plugins/_alerting/monitors//_execute ``` #### Sample response @@ -793,7 +793,7 @@ Returns an array of all alerts. #### Request ```json -GET _opensearch/_alerting/monitors/alerts +GET _plugins/_alerting/monitors/alerts ``` #### Response @@ -862,7 +862,7 @@ GET _opensearch/_alerting/monitors/alerts #### Request ```json -POST _opensearch/_alerting/monitors//_acknowledge/alerts +POST _plugins/_alerting/monitors//_acknowledge/alerts { "alerts": ["eQURa3gBKo1jAh6qUo49"] } @@ -886,7 +886,7 @@ POST _opensearch/_alerting/monitors//_acknowledge/alerts #### Requests ```json -POST _opensearch/_alerting/destinations +POST _plugins/_alerting/destinations { "name": "my-destination", "type": "slack", @@ -895,7 +895,7 @@ POST _opensearch/_alerting/destinations } } -POST _opensearch/_alerting/destinations +POST _plugins/_alerting/destinations { "type": "custom_webhook", "name": "my-custom-destination", @@ -939,7 +939,7 @@ POST _opensearch/_alerting/destinations #### Request ```json -PUT _opensearch/_alerting/destinations/ +PUT _plugins/_alerting/destinations/ { "name": "my-updated-destination", "type": "slack", @@ -976,7 +976,7 @@ Retrieve one destination. #### Requests ```json -GET _opensearch/_alerting/destinations/ +GET _plugins/_alerting/destinations/ ``` #### Sample response @@ -1021,7 +1021,7 @@ Retrieve all destinations. #### Requests ```json -GET _opensearch/_alerting/destinations +GET _plugins/_alerting/destinations ``` #### Sample response @@ -1064,7 +1064,7 @@ GET _opensearch/_alerting/destinations #### Request ``` -DELETE _opensearch/_alerting/destinations/ +DELETE _plugins/_alerting/destinations/ ``` #### Sample response @@ -1092,7 +1092,7 @@ DELETE _opensearch/_alerting/destinations/ #### Request ```json -POST _opensearch/_alerting/destinations/email_accounts +POST _plugins/_alerting/destinations/email_accounts { "name": "example_account", "email": "example@email.com", @@ -1124,7 +1124,7 @@ POST _opensearch/_alerting/destinations/email_accounts #### Request ```json -PUT _opensearch/_alerting/destinations/email_accounts/ +PUT _plugins/_alerting/destinations/email_accounts/ { "name": "example_account", "email": "example@email.com", @@ -1155,7 +1155,7 @@ PUT _opensearch/_alerting/destinations/email_accounts/ #### Request ```json -GET _opensearch/_alerting/destinations/email_accounts/ +GET _plugins/_alerting/destinations/email_accounts/ { "name": "example_account", "email": "example@email.com", @@ -1186,7 +1186,7 @@ GET _opensearch/_alerting/destinations/email_accounts/ #### Request ``` -DELETE _opensearch/_alerting/destinations/email_accounts/ +DELETE _plugins/_alerting/destinations/email_accounts/ ``` #### Sample response @@ -1213,7 +1213,7 @@ DELETE _opensearch/_alerting/destinations/email_accounts/ #### Request ```json -POST _opensearch/_alerting/destinations/email_accounts/_search +POST _plugins/_alerting/destinations/email_accounts/_search { "from": 0, "size": 20, @@ -1279,7 +1279,7 @@ POST _opensearch/_alerting/destinations/email_accounts/_search #### Request ```json -POST _opensearch/_alerting/destinations/email_groups +POST _plugins/_alerting/destinations/email_groups { "name": "example_email_group", "emails": [{ @@ -1313,7 +1313,7 @@ POST _opensearch/_alerting/destinations/email_groups #### Request ```json -PUT _opensearch/_alerting/destinations/email_groups/ +PUT _plugins/_alerting/destinations/email_groups/ { "name": "example_email_group", "emails": [{ @@ -1345,7 +1345,7 @@ PUT _opensearch/_alerting/destinations/email_groups/ #### Request ```json -GET _opensearch/_alerting/destinations/email_groups/ +GET _plugins/_alerting/destinations/email_groups/ { "name": "example_email_group", "emails": [{ @@ -1377,7 +1377,7 @@ GET _opensearch/_alerting/destinations/email_groups/ #### Request ``` -DELETE _opensearch/_alerting/destinations/email_groups/ +DELETE _plugins/_alerting/destinations/email_groups/ ``` #### Sample response @@ -1404,7 +1404,7 @@ DELETE _opensearch/_alerting/destinations/email_groups/ #### Request ```json -POST _opensearch/_alerting/destinations/email_groups/_search +POST _plugins/_alerting/destinations/email_groups/_search { "from": 0, "size": 20, diff --git a/docs/alerting/settings.md b/docs/alerting/settings.md index 324f5597..31052da2 100644 --- a/docs/alerting/settings.md +++ b/docs/alerting/settings.md @@ -34,26 +34,26 @@ All settings are available using the OpenSearch `_cluster/settings` API. None re Setting | Default | Description :--- | :--- | :--- -`opensearch.scheduled_jobs.enabled` | true | Whether the alerting plugin is enabled or not. If disabled, all monitors immediately stop running. -`opendistro.alerting.index_timeout` | 60s | The timeout for creating monitors and destinations using the REST APIs. -`opendistro.alerting.request_timeout` | 10s | The timeout for miscellaneous requests from the plugin. -`opendistro.alerting.action_throttle_max_value` | 24h | The maximum amount of time you can set for action throttling. By default, this value displays as 1440 minutes in OpenSearch Dashboards. -`opendistro.alerting.input_timeout` | 30s | How long the monitor can take to issue the search request. -`opendistro.alerting.bulk_timeout` | 120s | How long the monitor can write alerts to the alert index. -`opendistro.alerting.alert_backoff_count` | 3 | The number of retries for writing alerts before the operation fails. -`opendistro.alerting.alert_backoff_millis` | 50ms | The amount of time to wait between retries---increases exponentially after each failed retry. -`opendistro.alerting.alert_history_rollover_period` | 12h | How frequently to check whether the `.opendistro-alerting-alert-history-write` alias should roll over to a new history index and whether the Alerting plugin should delete any history indices. -`opendistro.alerting.move_alerts_backoff_millis` | 250 | The amount of time to wait between retries---increases exponentially after each failed retry. -`opendistro.alerting.move_alerts_backoff_count` | 3 | The number of retries for moving alerts to a deleted state after their monitor or trigger has been deleted. -`opendistro.alerting.monitor.max_monitors` | 1000 | The maximum number of monitors users can create. -`opendistro.alerting.alert_history_max_age` | 30d | The oldest document to store in the `.opensearch-alert-history-` index before creating a new index. If the number of alerts in this time period does not exceed `alert_history_max_docs`, alerting creates one history index per period (e.g. one index every 30 days). -`opendistro.alerting.alert_history_max_docs` | 1000 | The maximum number of alerts to store in the `.opensearch-alert-history-` index before creating a new index. -`opendistro.alerting.alert_history_enabled` | true | Whether to create `.opendistro-alerting-alert-history-` indices. -`opendistro.alerting.alert_history_retention_period` | 60d | The amount of time to keep history indices before automatically deleting them. -`opendistro.alerting.destination.allow_list` | ["chime", "slack", "custom_webhook", "email", "test_action"] | The list of allowed destinations. If you don't want to allow users to a certain type of destination, you can remove it from this list, but we recommend leaving this setting as-is. -`opendistro.alerting.filter_by_backend_roles` | "false" | Restricts access to monitors by backend role. See [Alerting security](../security/). -`opensearch.scheduled_jobs.sweeper.period` | 5m | The alerting feature uses its "job sweeper" component to periodically check for new or updated jobs. This setting is the rate at which the sweeper checks to see if any jobs (monitors) have changed and need to be rescheduled. -`opensearch.scheduled_jobs.sweeper.page_size` | 100 | The page size for the sweeper. You shouldn't need to change this value. -`opensearch.scheduled_jobs.sweeper.backoff_millis` | 50ms | The amount of time the sweeper waits between retries---increases exponentially after each failed retry. -`opensearch.scheduled_jobs.sweeper.retry_count` | 3 | The total number of times the sweeper should retry before throwing an error. -`opensearch.scheduled_jobs.request_timeout` | 10s | The timeout for the request that sweeps shards for jobs. +`plugins.scheduled_jobs.enabled` | true | Whether the alerting plugin is enabled or not. If disabled, all monitors immediately stop running. +`plugins.alerting.index_timeout` | 60s | The timeout for creating monitors and destinations using the REST APIs. +`plugins.alerting.request_timeout` | 10s | The timeout for miscellaneous requests from the plugin. +`plugins.alerting.action_throttle_max_value` | 24h | The maximum amount of time you can set for action throttling. By default, this value displays as 1440 minutes in OpenSearch Dashboards. +`plugins.alerting.input_timeout` | 30s | How long the monitor can take to issue the search request. +`plugins.alerting.bulk_timeout` | 120s | How long the monitor can write alerts to the alert index. +`plugins.alerting.alert_backoff_count` | 3 | The number of retries for writing alerts before the operation fails. +`plugins.alerting.alert_backoff_millis` | 50ms | The amount of time to wait between retries---increases exponentially after each failed retry. +`plugins.alerting.alert_history_rollover_period` | 12h | How frequently to check whether the `.opendistro-alerting-alert-history-write` alias should roll over to a new history index and whether the Alerting plugin should delete any history indices. +`plugins.alerting.move_alerts_backoff_millis` | 250 | The amount of time to wait between retries---increases exponentially after each failed retry. +`plugins.alerting.move_alerts_backoff_count` | 3 | The number of retries for moving alerts to a deleted state after their monitor or trigger has been deleted. +`plugins.alerting.monitor.max_monitors` | 1000 | The maximum number of monitors users can create. +`plugins.alerting.alert_history_max_age` | 30d | The oldest document to store in the `.opendistro-alert-history-` index before creating a new index. If the number of alerts in this time period does not exceed `alert_history_max_docs`, alerting creates one history index per period (e.g. one index every 30 days). +`plugins.alerting.alert_history_max_docs` | 1000 | The maximum number of alerts to store in the `.opendistro-alert-history-` index before creating a new index. +`plugins.alerting.alert_history_enabled` | true | Whether to create `.opendistro-alerting-alert-history-` indices. +`plugins.alerting.alert_history_retention_period` | 60d | The amount of time to keep history indices before automatically deleting them. +`plugins.alerting.destination.allow_list` | ["chime", "slack", "custom_webhook", "email", "test_action"] | The list of allowed destinations. If you don't want to allow users to a certain type of destination, you can remove it from this list, but we recommend leaving this setting as-is. +`plugins.alerting.filter_by_backend_roles` | "false" | Restricts access to monitors by backend role. See [Alerting security](../security/). +`plugins.scheduled_jobs.sweeper.period` | 5m | The alerting feature uses its "job sweeper" component to periodically check for new or updated jobs. This setting is the rate at which the sweeper checks to see if any jobs (monitors) have changed and need to be rescheduled. +`plugins.scheduled_jobs.sweeper.page_size` | 100 | The page size for the sweeper. You shouldn't need to change this value. +`plugins.scheduled_jobs.sweeper.backoff_millis` | 50ms | The amount of time the sweeper waits between retries---increases exponentially after each failed retry. +`plugins.scheduled_jobs.sweeper.retry_count` | 3 | The total number of times the sweeper should retry before throwing an error. +`plugins.scheduled_jobs.request_timeout` | 10s | The timeout for the request that sweeps shards for jobs.