{
  "id": "alerts",
  "title": "Node alerts requests",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/rest-api/requests/nodes/alerts/",
  "summary": "Node alert requests",
  "content": "\n| Method | Path | Description |\n|--------|------|-------------|\n| [GET](#get-all-nodes-alerts) | `/v1/nodes/alerts` | Get all alert states for all nodes |\n| [GET](#get-node-alerts) | `/v1/nodes/alerts/{uid}` | Get all alert states for a node |\n| [GET](#get-node-alert) | `/v1/nodes/alerts/{uid}/{alert}` | Get node alert state |\n\n## Get all alert states {#get-all-nodes-alerts}\n\n\tGET /v1/nodes/alerts\n\nGet all alert states for all nodes.\n\n#### Required permissions\n\n| Permission name |\n|-----------------|\n| [view_all_nodes_alerts]() |\n\n### Request {#get-all-request} \n\n#### Example HTTP request\n\n\tGET /v1/nodes/alerts \n\n#### Request headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| Host | cnm.cluster.fqdn | Domain name |\n| Accept | application/json | Accepted media type |\n\n#### Query parameters\n\n| Field | Type | Description |\n|-------|------|-------------|\n| ignore_settings | boolean | Retrieve updated alert state regardless of the cluster's alert_settings. When not present, a disabled alert will always be retrieved as disabled with a false state. (optional) |\n\n### Response {#get-all-response} \n\nReturns a hash of node UIDs and the [alert states]() for each node.\n\n#### Example JSON body\n\n```json\n{\n    \"1\": {\n        \"node_cpu_utilization\": {\n            \"change_time\": \"2014-12-22T10:42:00Z\",\n            \"change_value\": {\n                \"cpu_util\": 2.500000000145519,\n                \"global_threshold\": \"1\",\n                \"state\": true\n            },\n            \"enabled\": true,\n            \"state\": true,\n            \"severity\": \"WARNING\"\n        },\n        \"...\"\n    },\n    \"...\"\n}\n```\n\n### Status codes {#get-all-status-codes} \n\n| Code | Description |\n|------|-------------|\n| [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) | No error |\n\n## Get node alert states {#get-node-alerts}\n\n\tGET /v1/nodes/alerts/{int: uid}\n\nGet all alert states for a node.\n\n#### Required permissions\n\n| Permission name |\n|-----------------|\n| [view_node_alerts]() |\n\n### Request {#get-request-all-alerts} \n\n#### Example HTTP request\n\n\tGET /v1/nodes/alerts/1 \n\n\n#### Request headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| Host | cnm.cluster.fqdn | Domain name |\n| Accept | application/json | Accepted media type |\n\n\n#### Query parameters\n\n| Field | Type | Description |\n|-------|------|-------------|\n| ignore_settings | boolean | Retrieve updated alert state regardless of the cluster's alert_settings. When not present, a disabled alert will always be retrieved as disabled with a false state. (optional) |\n\n### Response {#get-response-all-alerts} \n\nReturns a hash of [alert objects]() and their states for a specific node.\n\n#### Example JSON body\n\n```json\n{\n   \"node_cpu_utilization\": {\n        \"change_time\": \"2014-12-22T10:42:00Z\",\n        \"change_value\": {\n            \"cpu_util\": 2.500000000145519,\n            \"global_threshold\": \"1\",\n            \"state\": true\n        },\n        \"enabled\": true,\n        \"state\": true,\n        \"severity\": \"WARNING\",\n    },\n    \"...\"\n}\n```\n\n### Status codes {#get-status-codes-all-alerts} \n\n| Code | Description |\n|------|-------------|\n| [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) | No error |\n| [404 Not Found](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5) | Specified node does not exist |\n\n## Get node alert state {#get-node-alert}\n\n\tGET /v1/nodes/alerts/{int: uid}/{alert}\n\nGet a node alert state.\n\n#### Required permissions\n\n| Permission name |\n|-----------------|\n| [view_node_alerts]() |\n\n### Request {#get-request} \n\n#### Example HTTP request\n\n\tGET /v1/nodes/alerts/1/node_cpu_utilization \n\n\n#### Request headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| Host | cnm.cluster.fqdn | Domain name |\n| Accept | application/json | Accepted media type |\n\n\n#### Query parameters\n\n| Field | Type | Description |\n|-------|------|-------------|\n| ignore_settings | boolean | Retrieve updated alert state regardless of the cluster's alert_settings. When not present, a disabled alert will always be retrieved as disabled with a false state. (optional) |\n\n### Response {#get-response} \n\nReturns an [alert object]().\n\n#### Example JSON body\n\n```json\n{\n    \"change_time\": \"2014-12-22T10:42:00Z\",\n    \"change_value\": {\n        \"cpu_util\": 2.500000000145519,\n        \"global_threshold\": \"1\",\n        \"state\": true\n    },\n    \"enabled\": true,\n    \"state\": true,\n    \"severity\": \"WARNING\",\n}\n```\n\n### Status codes {#get-status-codes} \n\n| Code | Description |\n|------|-------------|\n| [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) | No error |\n| [404 Not Found](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5) | Specified alert or node does not exist |\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}