diff options
Diffstat (limited to 'monitoring/ceph-mixin/tests_alerts/test_alerts.yml')
| -rw-r--r-- | monitoring/ceph-mixin/tests_alerts/test_alerts.yml | 293 |
1 files changed, 151 insertions, 142 deletions
diff --git a/monitoring/ceph-mixin/tests_alerts/test_alerts.yml b/monitoring/ceph-mixin/tests_alerts/test_alerts.yml index 680082d8981..71d77dcd91a 100644 --- a/monitoring/ceph-mixin/tests_alerts/test_alerts.yml +++ b/monitoring/ceph-mixin/tests_alerts/test_alerts.yml @@ -26,9 +26,9 @@ tests: type: ceph_default severity: critical exp_annotations: - summary: Cluster is in an ERROR state + summary: Cluster is in the ERROR state description: > - Ceph in HEALTH_ERROR state for more than 5 minutes. + The cluster state has been HEALTH_ERROR for more than 5 minutes. Please check "ceph health detail" for more information. # health warning @@ -54,9 +54,9 @@ tests: type: ceph_default severity: warning exp_annotations: - summary: Cluster is in a WARNING state + summary: Cluster is in the WARNING state description: > - Ceph has been in HEALTH_WARN for more than 15 minutes. + The cluster state has been HEALTH_WARN for more than 15 minutes. Please check "ceph health detail" for more information. # 10% OSDs down @@ -166,13 +166,13 @@ tests: type: ceph_default exp_annotations: documentation: https://docs.ceph.com/en/latest/rados/troubleshooting/troubleshooting-osd#flapping-osds - summary: Network issues are causing OSD's to flap (mark each other out) + summary: Network issues are causing OSDs to flap (mark each other down) description: > OSD osd.0 on ceph was - marked down and back up at 20.1 times once a minute for 5 minutes. - This could indicate a network issue (latency, packet drop, disruption) - on the clusters "cluster network". Check the network environment on the - listed host(s). + marked down and back up 20.1 times once a minute for 5 minutes. + This may indicate a network issue (latency, packet loss, MTU mismatch) + on the cluster network, or the public network if no cluster network + is deployed. Check the network stats on the listed host(s). # high pg count deviation - interval: 1m @@ -244,7 +244,7 @@ tests: severity: warning type: ceph_default exp_annotations: - summary: PG allocations are not balanced across devices + summary: PGs are not balanced across OSDs description: > OSD osd.1 on ceph deviates by more than 30% from average PG count. @@ -295,11 +295,11 @@ tests: severity: critical type: ceph_default exp_annotations: - summary: One or more Placement Groups are inactive + summary: One or more placement groups are inactive description: > 1 PGs have been inactive for more than 5 minutes in pool device_health_metrics. - Inactive placement groups aren't able to serve read/write + Inactive placement groups are not able to serve read/write requests. #pgs unclean @@ -351,12 +351,11 @@ tests: severity: warning type: ceph_default exp_annotations: - summary: One or more platcment groups are marked unclean + summary: One or more placement groups are marked unclean description: > - 1 PGs haven't been clean for more than 15 minutes in pool + 1 PGs have been unclean for more than 15 minutes in pool device_health_metrics. - Unclean PGs haven't been able to completely recover from a - previous failure. + Unclean PGs have not recovered from a previous failure. # root volume full - interval: 1m @@ -396,7 +395,7 @@ tests: exp_annotations: summary: Root filesystem is dangerously full description: > - Root volume (OSD and MON store) is dangerously full: 4.811% free. + Root volume is dangerously full: 4.811% free. # network packets dropped - interval: 1s @@ -437,7 +436,7 @@ tests: severity: warning type: ceph_default exp_annotations: - summary: One or more Nics is seeing packet drops + summary: One or more NICs reports packet drops description: > Node node-exporter experiences packet drop > 0.01% or > 10 packets/s on interface eth0. @@ -480,8 +479,8 @@ tests: oid: 1.3.6.1.4.1.50495.1.2.1.8.3 severity: warning type: ceph_default - exp_annotations: - summary: One or more Nics is seeing packet errors + exp_annotations: + summary: One or more NICs reports packet errors description: > Node node-exporter experiences packet errors > 0.01% or > 10 packets/s on interface eth0. @@ -523,11 +522,11 @@ tests: mountpoint: /rootfs nodename: node-1.unittests.com exp_annotations: - summary: Host filesystem freespace is getting low + summary: Host filesystem free space is getting low description: > Mountpoint /rootfs on node-1.unittests.com - will be full in less than 5 days assuming the average fill-up - rate of the past 48 hours. + will be full in less than 5 days based on the 48 hour trailing + fill rate. # MTU Mismatch - interval: 1m input_series: @@ -676,8 +675,8 @@ tests: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#pool-full summary: Pool is full - writes are blocked description: | - A pool has reached it's MAX quota, or the OSDs supporting the pool - have reached their FULL threshold. Until this is resolved, writes to + A pool has reached its MAX quota, or OSDs supporting the pool + have reached the FULL threshold. Until this is resolved, writes to the pool will be blocked. Pool Breakdown (top 5) - rbd at 96% @@ -685,8 +684,8 @@ tests: - default.rgw.index at 72% - cephfs_data at 32% - default.rgw.log at 19% - Either increase the pools quota, or add capacity to the cluster first - then increase it's quota (e.g. ceph osd pool set quota <pool_name> max_bytes <bytes>) + Increase the pool's quota, or add capacity to the cluster first + then increase the pool's quota (e.g. ceph osd pool set quota <pool_name> max_bytes <bytes>) # slow OSD ops - interval : 1m input_series: @@ -710,10 +709,9 @@ tests: type: ceph_default exp_annotations: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#slow-ops - summary: MON/OSD operations are slow to complete + summary: OSD operations are slow to complete description: > - 1 OSD requests are taking too long to process - (osd_op_complaint_time exceeded) + 1 OSD requests are taking too long to process (osd_op_complaint_time exceeded) # CEPHADM orchestrator alert triggers - interval: 30s @@ -822,13 +820,11 @@ tests: oid: 1.3.6.1.4.1.50495.1.2.1.5.1 exp_annotations: documentation: https://docs.ceph.com/en/latest/cephfs/health-messages#cephfs-health-messages - summary: Ceph filesystem is damaged. + summary: CephFS filesystem is damaged. description: > - The filesystems metadata has been corrupted. Data access - may be blocked. - - Either analyse the output from the mds daemon admin socket, or - escalate to support + Filesystem metadata has been corrupted. Data may be inaccessible. + Analyze metrics from the MDS daemon admin socket, or + escalate to support. - interval: 1m input_series: - series: 'ceph_health_detail{name="MDS_HEALTH_READ_ONLY"}' @@ -852,13 +848,13 @@ tests: oid: 1.3.6.1.4.1.50495.1.2.1.5.2 exp_annotations: documentation: https://docs.ceph.com/en/latest/cephfs/health-messages#cephfs-health-messages - summary: Ceph filesystem in read only mode, due to write error(s) + summary: CephFS filesystem in read only mode due to write error(s) description: > The filesystem has switched to READ ONLY due to an unexpected - write error, when writing to the metadata pool + error when writing to the metadata pool. - Either analyse the output from the mds daemon admin socket, or - escalate to support + Either analyze the output from the MDS daemon admin socket, or + escalate to support. - interval: 1m input_series: - series: 'ceph_health_detail{name="MDS_ALL_DOWN"}' @@ -882,10 +878,10 @@ tests: oid: 1.3.6.1.4.1.50495.1.2.1.5.3 exp_annotations: documentation: https://docs.ceph.com/en/latest/cephfs/health-messages/#mds-all-down - summary: Ceph filesystem is offline + summary: CephFS filesystem is offline description: > - All MDS ranks are unavailable. The ceph daemons providing the metadata - for the Ceph filesystem are all down, rendering the filesystem offline. + All MDS ranks are unavailable. The MDS daemons managing metadata + are down, rendering the filesystem offline. - interval: 1m input_series: - series: 'ceph_health_detail{name="FS_DEGRADED"}' @@ -909,11 +905,11 @@ tests: oid: 1.3.6.1.4.1.50495.1.2.1.5.4 exp_annotations: documentation: https://docs.ceph.com/en/latest/cephfs/health-messages/#fs-degraded - summary: Ceph filesystem is degraded + summary: CephFS filesystem is degraded description: > One or more metadata daemons (MDS ranks) are failed or in a damaged state. At best the filesystem is partially available, - worst case is the filesystem is completely unusable. + at worst the filesystem is completely unusable. - interval: 1m input_series: - series: 'ceph_health_detail{name="MDS_INSUFFICIENT_STANDBY"}' @@ -936,11 +932,11 @@ tests: type: ceph_default exp_annotations: documentation: https://docs.ceph.com/en/latest/cephfs/health-messages/#mds-insufficient-standby - summary: Ceph filesystem standby daemons too low + summary: Ceph filesystem standby daemons too few description: > - The minimum number of standby daemons determined by standby_count_wanted - is less than the actual number of standby daemons. Adjust the standby count - or increase the number of mds daemons within the filesystem. + The minimum number of standby daemons required by standby_count_wanted + is less than the current number of standby daemons. Adjust the standby count + or increase the number of MDS daemons. - interval: 1m input_series: - series: 'ceph_health_detail{name="FS_WITH_FAILED_MDS"}' @@ -964,11 +960,11 @@ tests: oid: 1.3.6.1.4.1.50495.1.2.1.5.5 exp_annotations: documentation: https://docs.ceph.com/en/latest/cephfs/health-messages/#fs-with-failed-mds - summary: Ceph MDS daemon failed, no further standby available + summary: MDS daemon failed, no further standby available description: > - An MDS daemon has failed, leaving only one active rank without - further standby. Investigate the cause of the failure or add a - standby daemon + An MDS daemon has failed, leaving only one active rank and no + available standby. Investigate the cause of the failure or add a + standby MDS. - interval: 1m input_series: - series: 'ceph_health_detail{name="MDS_UP_LESS_THAN_MAX"}' @@ -993,9 +989,9 @@ tests: documentation: https://docs.ceph.com/en/latest/cephfs/health-messages/#mds-up-less-than-max summary: Ceph MDS daemon count is lower than configured description: > - The filesystem's "max_mds" setting defined the number of MDS ranks in + The filesystem's "max_mds" setting defines the number of MDS ranks in the filesystem. The current number of active MDS daemons is less than - this setting. + this value. # MGR - interval: 1m input_series: @@ -1020,16 +1016,16 @@ tests: type: ceph_default oid: 1.3.6.1.4.1.50495.1.2.1.6.2 exp_annotations: - summary: Ceph's mgr/prometheus module is not available + summary: The mgr/prometheus module is not available description: > The mgr/prometheus module at ceph-mgr:9283 is unreachable. This - could mean that the module has been disabled or the mgr itself is down. + could mean that the module has been disabled or the mgr daemon itself is down. Without the mgr/prometheus module metrics and alerts will no longer - function. Open a shell to ceph and use 'ceph -s' to to determine whether the - mgr is active. If the mgr is not active, restart it, otherwise you can check - the mgr/prometheus module is loaded with 'ceph mgr module ls' and if it's - not listed as enabled, enable it with 'ceph mgr module enable prometheus' + function. Open a shell to an admin node or toolbox pod and use 'ceph -s' to to determine whether the + mgr is active. If the mgr is not active, restart it, otherwise you can determine + module status with 'ceph mgr module ls'. If it is + not listed as enabled, enable it with 'ceph mgr module enable prometheus'. - interval: 1m input_series: - series: 'ceph_health_detail{name="RECENT_MGR_MODULE_CRASH"}' @@ -1053,11 +1049,11 @@ tests: oid: 1.3.6.1.4.1.50495.1.2.1.6.1 exp_annotations: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#recent-mgr-module-crash - summary: A mgr module has recently crashed + summary: A manager module has recently crashed description: > - One or more mgr modules have crashed and are yet to be acknowledged by the administrator. A - crashed module may impact functionality within the cluster. Use the 'ceph crash' commands to - investigate which module has failed, and archive it to acknowledge the failure. + One or more mgr modules have crashed and have yet to be acknowledged by an administrator. A + crashed module may impact functionality within the cluster. Use the 'ceph crash' command to + determine which module has failed, and archive it to acknowledge the failure. # MON - interval: 1m input_series: @@ -1084,11 +1080,15 @@ tests: oid: 1.3.6.1.4.1.50495.1.2.1.3.2 exp_annotations: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#mon-disk-crit - summary: Disk space on at least one monitor is critically low + summary: Filesystem space on at least one monitor is critically low description: | - The free space available to a monitor's store is critically low (<5% by default). - You should increase the space available to the monitor(s). The - default location for the store sits under /var/lib/ceph. Your monitor hosts are; + The free space available to a monitor's store is critically low. + You should increase the space available to the monitor(s). The default directory + is /var/lib/ceph/mon-*/data/store.db on traditional deployments, + and /var/lib/rook/mon-*/data/store.db on the mon pod's worker node for Rook. + Look for old, rotated versions of *.log and MANIFEST*. Do NOT touch any *.sst files. + Also check any other directories under /var/lib/rook and other directories on the + same filesystem, often /var/log and /var/tmp are culprits. Your monitor hosts are; - ceph-mon-a - interval: 1m input_series: @@ -1117,8 +1117,12 @@ tests: summary: Disk space on at least one monitor is approaching full description: | The space available to a monitor's store is approaching full (>70% is the default). - You should increase the space available to the monitor store. The - default location for the store sits under /var/lib/ceph. Your monitor hosts are; + You should increase the space available to the monitor(s). The default directory + is /var/lib/ceph/mon-*/data/store.db on traditional deployments, + and /var/lib/rook/mon-*/data/store.db on the mon pod's worker node for Rook. + Look for old, rotated versions of *.log and MANIFEST*. Do NOT touch any *.sst files. + Also check any other directories under /var/lib/rook and other directories on the + same filesystem, often /var/log and /var/tmp are culprits. Your monitor hosts are; - ceph-mon-a - interval: 1m input_series: @@ -1142,14 +1146,15 @@ tests: type: ceph_default exp_annotations: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#mon-clock-skew - summary: Clock skew across the Monitor hosts detected + summary: Clock skew detected among monitors description: | - The ceph monitors rely on a consistent time reference to maintain - quorum and cluster consistency. This event indicates that at least - one of your mons is not sync'd correctly. + Ceph monitors rely on closely synchronized time to maintain + quorum and cluster consistency. This event indicates that the time on at least + one mon has drifted too far from the lead mon. - Review the cluster status with ceph -s. This will show which monitors - are affected. Check the time sync status on each monitor host. + Review cluster status with ceph -s. This will show which monitors + are affected. Check the time sync status on each monitor host with + "ceph time-sync-status" and the state and peers of your ntpd or chrony daemon. # Check 3 mons one down, quorum at risk - interval: 1m @@ -1190,7 +1195,7 @@ tests: summary: Monitor quorum is at risk description: | Quorum requires a majority of monitors (x 2) to be active - Without quorum the cluster will become inoperable, affecting all connected clients and services. + Without quorum the cluster will become inoperable, affecting all services and connected clients. The following monitors are down: - mon.c on ceph-mon-3 @@ -1234,10 +1239,10 @@ tests: type: ceph_default exp_annotations: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#mon-down - summary: One of more ceph monitors are down + summary: One or more monitors down description: | You have 1 monitor down. - Quorum is still intact, but the loss of further monitors will make your cluster inoperable. + Quorum is still intact, but the loss of an additional monitor will make your cluster inoperable. The following monitors are down: - mon.e on ceph-mon-5 @@ -1264,14 +1269,14 @@ tests: type: ceph_default exp_annotations: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#id2 - summary: Device(s) have been predicted to fail soon + summary: Device(s) predicted to fail soon description: | The device health module has determined that one or more devices will fail - soon. To review the device states use 'ceph device ls'. To show a specific + soon. To review device status use 'ceph device ls'. To show a specific device use 'ceph device info <dev id>'. - Mark the OSD as out (so data may migrate to other OSDs in the cluster). Once - the osd is empty remove and replace the OSD. + Mark the OSD out so that data may migrate to other OSDs. Once + the OSD has drained, destroy the OSD, replace the device, and redeploy the OSD. - interval: 1m input_series: - series: 'ceph_health_detail{name="DEVICE_HEALTH_TOOMANY"}' @@ -1295,12 +1300,12 @@ tests: oid: 1.3.6.1.4.1.50495.1.2.1.4.7 exp_annotations: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#device-health-toomany - summary: Too many devices have been predicted to fail, unable to resolve + summary: Too many devices are predicted to fail, unable to resolve description: | - The device health module has determined that the number of devices predicted to - fail can not be remediated automatically, since it would take too many osd's out of - the cluster, impacting performance and potentially availabililty. You should add new - OSDs to the cluster to allow data to be relocated to avoid the data integrity issues. + The device health module has determined that devices predicted to + fail can not be remediated automatically, since too many OSDs would be removed from + the cluster to ensure performance and availabililty. Prevent data + integrity issues by adding new OSDs so that data may be relocated. - interval: 1m input_series: - series: 'ceph_health_detail{name="DEVICE_HEALTH_IN_USE"}' @@ -1323,15 +1328,15 @@ tests: type: ceph_default exp_annotations: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#device-health-in-use - summary: A device failure is predicted, but unable to relocate data + summary: Device failure is predicted, but unable to relocate data description: | The device health module has determined that one or more devices will fail soon, but the normal process of relocating the data on the device to other OSDs in the cluster is blocked. - Check the the cluster has available freespace. It may be necessary to add - more disks to the cluster to allow the data from the failing device to - successfully migrate. + Ensure that the cluster has available free space. It may be necessary to add + capacity to the cluster to allow data from the failing device to + successfully migrate, or to enable the balancer. # OSD - interval: 1m input_series: @@ -1387,7 +1392,7 @@ tests: summary: Network issues delaying OSD heartbeats (public network) description: | OSD heartbeats on the cluster's 'public' network (frontend) are running slow. Investigate the network - for any latency issues on this subnet. Use 'ceph health detail' to show the affected OSDs. + for latency or loss issues. Use 'ceph health detail' to show the affected OSDs. - interval: 1m input_series: - series: 'ceph_health_detail{name="OSD_SLOW_PING_TIME_BACK"}' @@ -1412,7 +1417,7 @@ tests: summary: Network issues delaying OSD heartbeats (cluster network) description: | OSD heartbeats on the cluster's 'cluster' network (backend) are running slow. Investigate the network - for any latency issues on this subnet. Use 'ceph health detail' to show the affected OSDs. + for latency or loss issues. Use 'ceph health detail' to show the affected OSDs. - interval: 1m input_series: - series: 'ceph_health_detail{name="BLUESTORE_DISK_SIZE_MISMATCH"}' @@ -1437,8 +1442,8 @@ tests: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#bluestore-disk-size-mismatch summary: OSD size inconsistency error description: | - One or more OSDs have an internal inconsistency between the size of the physical device and it's metadata. - This could lead to the OSD(s) crashing in future. You should redeploy the effected OSDs. + One or more OSDs have an internal inconsistency between metadata and the size of the device. + This could lead to the OSD(s) crashing in future. You should redeploy the affected OSDs. - interval: 30s input_series: - series: 'ceph_health_detail{name="BLUESTORE_SPURIOUS_READ_ERRORS"}' @@ -1464,7 +1469,7 @@ tests: summary: Device read errors detected description: > An OSD has encountered read errors, but the OSD has recovered by retrying - the reads. This may indicate an issue with the Hardware or Kernel. + the reads. This may indicate an issue with hardware or the kernel. - interval: 1m input_series: - series: 'ceph_health_detail{name="OSD_DOWN"}' @@ -1500,7 +1505,7 @@ tests: oid: 1.3.6.1.4.1.50495.1.2.1.4.2 exp_annotations: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#osd-down - summary: An OSD has been marked down/unavailable + summary: An OSD has been marked down description: | 1 OSD down for over 5mins. @@ -1531,10 +1536,10 @@ tests: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#osd-nearfull summary: OSD(s) running low on free space (NEARFULL) description: | - One or more OSDs have reached their NEARFULL threshold + One or more OSDs have reached the NEARFULL threshold - Use 'ceph health detail' to identify which OSDs have reached this threshold. - To resolve, either add capacity to the cluster, or delete unwanted data + Use 'ceph health detail' and 'ceph osd df' to identify the problem. + To resolve, add capacity to the affected OSD's failure domain, restore down/out OSDs, or delete unwanted data. - interval: 1m input_series: - series: 'ceph_health_detail{name="OSD_FULL"}' @@ -1558,12 +1563,13 @@ tests: oid: 1.3.6.1.4.1.50495.1.2.1.4.6 exp_annotations: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#osd-full - summary: OSD(s) is full, writes blocked + summary: OSD full, writes blocked description: | - An OSD has reached it's full threshold. Writes from all pools that share the + An OSD has reached the FULL threshold. Writes to pools that share the affected OSD will be blocked. - To resolve, either add capacity to the cluster, or delete unwanted data + Use 'ceph health detail' and 'ceph osd df' to identify the problem. + To resolve, add capacity to the affected OSD's failure domain, restore down/out OSDs, or delete unwanted data. - interval: 1m input_series: - series: 'ceph_health_detail{name="OSD_BACKFILLFULL"}' @@ -1588,10 +1594,11 @@ tests: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#osd-backfillfull summary: OSD(s) too full for backfill operations description: | - An OSD has reached it's BACKFILL FULL threshold. This will prevent rebalance operations - completing for some pools. Check the current capacity utilisation with 'ceph df' + An OSD has reached the BACKFILL FULL threshold. This will prevent rebalance operations + from completing. + Use 'ceph health detail' and 'ceph osd df' to identify the problem. - To resolve, either add capacity to the cluster, or delete unwanted data + To resolve, add capacity to the affected OSD's failure domain, restore down/out OSDs, or delete unwanted data. - interval: 30s input_series: - series: 'ceph_health_detail{name="OSD_TOO_MANY_REPAIRS"}' @@ -1614,7 +1621,7 @@ tests: type: ceph_default exp_annotations: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#osd-too-many-repairs - summary: OSD has hit a high number of read errors + summary: OSD reports a high number of read errors description: | Reads from an OSD have used a secondary PG to return data to the client, indicating a potential failing disk. @@ -1649,7 +1656,7 @@ tests: type: ceph_default oid: 1.3.6.1.4.1.50495.1.2.1.9.2 exp_annotations: - summary: Pool growth rate may soon exceed it's capacity + summary: Pool growth rate may soon exceed capacity description: > Pool 'rbd' will be full in less than 5 days assuming the average fill-up rate of the past 48 hours. @@ -1674,11 +1681,11 @@ tests: severity: warning type: ceph_default exp_annotations: - summary: Freespace in a pool is too low for recovery/rebalance + summary: Free space in a pool is too low for recovery/backfill description: > - A pool is approaching it's near full threshold, which will - prevent rebalance operations from completing. You should - consider adding more capacity to the pool. + A pool is approaching the near full threshold, which will + prevent recovery/backfill operations from completing. + Consider adding more capacity. - interval: 1m input_series: @@ -1701,17 +1708,18 @@ tests: severity: warning type: ceph_default exp_annotations: - summary: One or more Ceph pools are getting full + summary: One or more Ceph pools are nearly full description: | - A pool has exceeeded it warning (percent full) threshold, or the OSDs - supporting the pool have reached their NEARFULL thresholds. Writes may - continue, but you are at risk of the pool going read only if more capacity + A pool has exceeeded the warning (percent full) threshold, or OSDs + supporting the pool have reached the NEARFULL threshold. Writes may + continue, but you are at risk of the pool going read-only if more capacity isn't made available. - Determine the affected pool with 'ceph df detail', for example looking - at QUOTA BYTES and STORED. Either increase the pools quota, or add - capacity to the cluster first then increase it's quota - (e.g. ceph osd pool set quota <pool_name> max_bytes <bytes>) + Determine the affected pool with 'ceph df detail', looking + at QUOTA BYTES and STORED. Increase the pool's quota, or add + capacity to the cluster first then increase the pool's quota + (e.g. ceph osd pool set quota <pool_name> max_bytes <bytes>). + Also ensure that the balancer is active. # PGs - interval: 1m @@ -1738,10 +1746,10 @@ tests: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#pg-not-scrubbed summary: Placement group(s) have not been scrubbed description: | - One or more PGs have not been scrubbed recently. The scrub process is a data integrity - feature, protectng against bit-rot. It checks that objects and their metadata (size and - attributes) match across object replicas. When PGs miss their scrub window, it may - indicate the scrub window is too small, or PGs were not in a 'clean' state during the + One or more PGs have not been scrubbed recently. Scrubs check metadata integrity, + protecting against bit-rot. They check that metadata + is consistent across data replicas. When PGs miss their scrub interval, it may + indicate that the scrub window is too small, or PGs were not in a 'clean' state during the scrub window. You can manually initiate a scrub with: ceph pg scrub <pgid> @@ -1802,10 +1810,11 @@ tests: description: | The number of placement groups per OSD is too high (exceeds the mon_max_pg_per_osd setting). - Check that the pg_autoscaler hasn't been disabled for any of the pools, with 'ceph osd pool autoscale-status' + Check that the pg_autoscaler has not been disabled for any pools with 'ceph osd pool autoscale-status', and that the profile selected is appropriate. You may also adjust the target_size_ratio of a pool to guide the autoscaler based on the expected relative size of the pool - (i.e. 'ceph osd pool set cephfs.cephfs.meta target_size_ratio .1') + ('ceph osd pool set cephfs.cephfs.meta target_size_ratio .1') or set the pg_autoscaler + mode to "warn" and adjust pg_num appropriately for one or more pools. - interval: 1m input_series: - series: 'ceph_health_detail{name="PG_RECOVERY_FULL"}' @@ -1829,10 +1838,10 @@ tests: oid: 1.3.6.1.4.1.50495.1.2.1.7.5 exp_annotations: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#pg-recovery-full - summary: OSDs are too full for automatic recovery + summary: OSDs are too full for recovery description: > - Data redundancy may be reduced, or is at risk, since one or more OSDs are at or above their - 'full' threshold. Add more capacity to the cluster, or delete unwanted data. + Data redundancy is at risk since one or more OSDs are at or above the + 'full' threshold. Add more capacity to the cluster, restore down/out OSDs, or delete unwanted data. - interval: 1m input_series: - series: 'ceph_health_detail{name="PG_BACKFILL_FULL"}' @@ -1856,10 +1865,10 @@ tests: oid: 1.3.6.1.4.1.50495.1.2.1.7.6 exp_annotations: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#pg-backfill-full - summary: Backfill operations are blocked, due to lack of freespace + summary: Backfill operations are blocked due to lack of free space description: > Data redundancy may be at risk due to lack of free space within the cluster. One or more OSDs - have breached their 'backfillfull' threshold. Add more capacity, or delete unwanted data. + have reached the 'backfillfull' threshold. Add more capacity, or delete unwanted data. - interval: 1m input_series: - series: 'ceph_health_detail{name="PG_AVAILABILITY"}' @@ -1891,10 +1900,10 @@ tests: oid: 1.3.6.1.4.1.50495.1.2.1.7.3 exp_annotations: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#pg-availability - summary: Placement group is unavailable, blocking some I/O + summary: PG is unavailable, blocking I/O description: > - Data availability is reduced impacting the clusters ability to service I/O to some data. One or - more placement groups (PGs) are in a state that blocks IO. + Data availability is reduced, impacting the cluster's ability to service I/O. One or + more placement groups (PGs) are in a state that blocks I/O. - interval: 1m input_series: - series: 'ceph_health_detail{name="PG_NOT_DEEP_SCRUBBED"}' @@ -1919,9 +1928,9 @@ tests: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#pg-not-deep-scrubbed summary: Placement group(s) have not been deep scrubbed description: | - One or more PGs have not been deep scrubbed recently. Deep scrub is a data integrity - feature, protectng against bit-rot. It compares the contents of objects and their - replicas for inconsistency. When PGs miss their deep scrub window, it may indicate + One or more PGs have not been deep scrubbed recently. Deep scrubs + protect against bit-rot. They compare data + replicas to ensure consistency. When PGs miss their deep scrub interval, it may indicate that the window is too small or PGs were not in a 'clean' state during the deep-scrub window. @@ -1991,9 +2000,9 @@ tests: oid: 1.3.6.1.4.1.50495.1.2.1.10.1 exp_annotations: documentation: https://docs.ceph.com/en/latest/rados/operations/health-checks#object-unfound - summary: Object(s) has been marked UNFOUND + summary: Object(s) marked UNFOUND description: | - A version of a RADOS object can not be found, even though all OSDs are up. I/O + The latest version of a RADOS object can not be found, even though all OSDs are up. I/O requests for this object from clients will block (hang). Resolving this issue may require the object to be rolled back to a prior version manually, and manually verified. # Generic Alerts @@ -2024,5 +2033,5 @@ tests: summary: One or more Ceph daemons have crashed, and are pending acknowledgement description: | One or more daemons have crashed recently, and need to be acknowledged. This notification - ensures that software crashes don't go unseen. To acknowledge a crash, use the + ensures that software crashes do not go unseen. To acknowledge a crash, use the 'ceph crash archive <id>' command. |