2017-07-25 14:13:02 +00:00
=============
Health checks
=============
Overview
========
There is a finite set of possible health messages that a Ceph cluster can
raise -- these are defined as *health checks* which have unique identifiers.
The identifier is a terse pseudo-human-readable (i.e. like a variable name)
string. It is intended to enable tools (such as UIs) to make sense of
health checks, and present them in a way that reflects their meaning.
This page lists the health checks that are raised by the monitor and manager
daemons. In addition to these, you may also see health checks that originate
2017-08-15 12:43:00 +00:00
from MDS daemons (see :ref: `cephfs-health-messages` ), and health checks
2017-07-25 14:13:02 +00:00
that are defined by ceph-mgr python modules.
Definitions
===========
2019-01-09 03:38:42 +00:00
Monitor
-------
MON_DOWN
________
One or more monitor daemons is currently down. The cluster requires a
majority (more than 1/2) of the monitors in order to function. When
one or more monitors are down, clients may have a harder time forming
their initial connection to the cluster as they may need to try more
addresses before they reach an operating monitor.
The down monitor daemon should generally be restarted as soon as
possible to reduce the risk of a subsequen monitor failure leading to
a service outage.
MON_CLOCK_SKEW
______________
The clocks on the hosts running the ceph-mon monitor daemons are not
sufficiently well synchronized. This health alert is raised if the
cluster detects a clock skew greater than `` mon_clock_drift_allowed `` .
This is best resolved by synchronizing the clocks using a tool like
`` ntpd `` or `` chrony `` .
If it is impractical to keep the clocks closely synchronized, the
`` mon_clock_drift_allowed `` threshold can also be increased, but this
value must stay significantly below the `` mon_lease `` interval in
order for monitor cluster to function properly.
2019-01-09 03:53:45 +00:00
MON_MSGR2_NOT_ENABLED
_____________________
The `` ms_bind_msgr2 `` option is enabled but one or more monitors is
not configured to bind to a v2 port in the cluster's monmap. This
means that features specific to the msgr2 protocol (e.g., encryption)
are not available on some or all connections.
In most cases this can be corrected by issuing the command::
ceph mon enable-msgr2
That command will change any monitor configured for the old default
port 6789 to continue to listen for v1 connections on 6789 and also
listen for v2 connections on the new default 3300 port.
If a monitor is configured to listen for v1 connections on a non-standard port (not 6789), then the monmap will need to be modified manually.
2017-11-28 18:05:57 +00:00
Manager
-------
MGR_MODULE_DEPENDENCY
_____________________
An enabled manager module is failing its dependency check. This health check
should come with an explanatory message from the module about the problem.
For example, a module might report that a required package is not installed:
install the required package and restart your manager daemons.
This health check is only applied to enabled modules. If a module is
not enabled, you can see whether it is reporting dependency issues in
the output of `ceph module ls` .
MGR_MODULE_ERROR
________________
A manager module has experienced an unexpected error. Typically,
this means an unhandled exception was raised from the module's `serve`
function. The human readable description of the error may be obscurely
worded if the exception did not provide a useful description of itself.
This health check may indicate a bug: please open a Ceph bug report if you
think you have encountered a bug.
If you believe the error is transient, you may restart your manager
daemon(s), or use `ceph mgr fail` on the active daemon to prompt
a failover to another daemon.
2017-07-25 14:13:02 +00:00
OSDs
----
OSD_DOWN
________
2017-07-27 02:05:35 +00:00
One or more OSDs are marked down. The ceph-osd daemon may have been
stopped, or peer OSDs may be unable to reach the OSD over the network.
Common causes include a stopped or crashed daemon, a down host, or a
network outage.
Verify the host is healthy, the daemon is started, and network is
functioning. If the daemon has crashed, the daemon log file
(`` /var/log/ceph/ceph-osd.* `` ) may contain debugging information.
2017-07-25 14:13:02 +00:00
2017-08-01 09:16:39 +00:00
OSD_<crush type>_DOWN
2017-07-25 14:13:02 +00:00
_____________________
(e.g. OSD_HOST_DOWN, OSD_ROOT_DOWN)
All the OSDs within a particular CRUSH subtree are marked down, for example
all OSDs on a host.
OSD_ORPHAN
__________
2017-07-27 02:05:35 +00:00
An OSD is referenced in the CRUSH map hierarchy but does not exist.
The OSD can be removed from the CRUSH hierarchy with::
ceph osd crush rm osd.<id>
2017-07-25 14:13:02 +00:00
OSD_OUT_OF_ORDER_FULL
_____________________
2017-07-27 02:05:35 +00:00
The utilization thresholds for `backfillfull` , `nearfull` , `full` ,
and/or `failsafe_full` are not ascending. In particular, we expect
`backfillfull < nearfull` , `nearfull < full` , and `full <
failsafe_full`.
The thresholds can be adjusted with::
ceph osd set-backfillfull-ratio <ratio>
ceph osd set-nearfull-ratio <ratio>
ceph osd set-full-ratio <ratio>
2017-07-25 14:13:02 +00:00
OSD_FULL
________
2017-07-27 02:05:35 +00:00
One or more OSDs has exceeded the `full` threshold and is preventing
the cluster from servicing writes.
Utilization by pool can be checked with::
ceph df
2017-07-25 14:13:02 +00:00
2017-07-27 02:05:35 +00:00
The currently defined `full` ratio can be seen with::
ceph osd dump | grep full_ratio
A short-term workaround to restore write availability is to raise the full
threshold by a small amount::
2017-07-25 14:13:02 +00:00
2017-07-27 02:05:35 +00:00
ceph osd set-full-ratio <ratio>
New storage should be added to the cluster by deploying more OSDs or
existing data should be deleted in order to free up space.
2017-08-15 12:43:00 +00:00
2017-07-25 14:13:02 +00:00
OSD_BACKFILLFULL
________________
2017-07-27 02:05:35 +00:00
One or more OSDs has exceeded the `backfillfull` threshold, which will
prevent data from being allowed to rebalance to this device. This is
an early warning that rebalancing may not be able to complete and that
the cluster is approaching full.
Utilization by pool can be checked with::
ceph df
2017-07-25 14:13:02 +00:00
OSD_NEARFULL
____________
2017-07-27 02:05:35 +00:00
One or more OSDs has exceeded the `nearfull` threshold. This is an early
warning that the cluster is approaching full.
Utilization by pool can be checked with::
ceph df
2017-07-25 14:13:02 +00:00
OSDMAP_FLAGS
____________
2017-07-27 02:05:35 +00:00
One or more cluster flags of interest has been set. These flags include:
2019-04-26 07:34:06 +00:00
* *full* - the cluster is flagged as full and cannot serve writes
2017-07-27 02:05:35 +00:00
* *pauserd* , *pausewr* - paused reads or writes
* *noup* - OSDs are not allowed to start
* *nodown* - OSD failure reports are being ignored, such that the
monitors will not mark OSDs `down`
* *noin* - OSDs that were previously marked `out` will not be marked
back `in` when they start
* *noout* - down OSDs will not automatically be marked out after the
configured interval
* *nobackfill* , *norecover* , *norebalance* - recovery or data
rebalancing is suspended
* *noscrub* , *nodeep_scrub* - scrubbing is disabled
* *notieragent* - cache tiering activity is suspended
With the exception of *full* , these flags can be set or cleared with::
ceph osd set <flag>
ceph osd unset <flag>
2017-08-15 12:43:00 +00:00
2017-07-25 14:13:02 +00:00
OSD_FLAGS
_________
2019-04-26 07:34:06 +00:00
One or more OSDs or CRUSH {nodes,device classes} has a flag of interest set.
These flags include:
2017-07-27 02:05:35 +00:00
2019-04-12 16:10:35 +00:00
* *noup* : these OSDs are not allowed to start
* *nodown* : failure reports for these OSDs will be ignored
* *noin* : if these OSDs were previously marked `out` automatically
after a failure, they will not be marked in when they start
* *noout* : if these OSDs are down they will not automatically be marked
2017-07-27 02:05:35 +00:00
`out` after the configured interval
2019-04-26 07:34:06 +00:00
These flags can be set and cleared in batch with::
2017-07-27 02:05:35 +00:00
2019-04-26 07:34:06 +00:00
ceph osd set-group <flags> <who>
ceph osd unset-group <flags> <who>
2017-07-27 02:05:35 +00:00
For example, ::
2019-04-26 07:34:06 +00:00
ceph osd set-group noup,noout osd.0 osd.1
ceph osd unset-group noup,noout osd.0 osd.1
ceph osd set-group noup,noout host-foo
ceph osd unset-group noup,noout host-foo
ceph osd set-group noup,noout class-hdd
ceph osd unset-group noup,noout class-hdd
2017-07-25 14:13:02 +00:00
OLD_CRUSH_TUNABLES
__________________
2017-07-27 02:05:35 +00:00
The CRUSH map is using very old settings and should be updated. The
oldest tunables that can be used (i.e., the oldest client version that
can connect to the cluster) without triggering this health warning is
determined by the `` mon_crush_min_required_version `` config option.
2017-08-15 12:43:00 +00:00
See :ref: `crush-map-tunables` for more information.
2017-07-25 14:13:02 +00:00
OLD_CRUSH_STRAW_CALC_VERSION
____________________________
2017-07-27 02:05:35 +00:00
The CRUSH map is using an older, non-optimal method for calculating
intermediate weight values for `` straw `` buckets.
The CRUSH map should be updated to use the newer method
(`` straw_calc_version=1 `` ). See
2017-08-15 12:43:00 +00:00
:ref: `crush-map-tunables` for more information.
2017-07-25 14:13:02 +00:00
CACHE_POOL_NO_HIT_SET
_____________________
2017-07-27 02:05:35 +00:00
One or more cache pools is not configured with a *hit set* to track
utilization, which will prevent the tiering agent from identifying
cold objects to flush and evict from the cache.
Hit sets can be configured on the cache pool with::
ceph osd pool set <poolname> hit_set_type <type>
ceph osd pool set <poolname> hit_set_period <period-in-seconds>
ceph osd pool set <poolname> hit_set_count <number-of-hitsets>
2017-08-15 12:43:00 +00:00
ceph osd pool set <poolname> hit_set_fpp <target-false-positive-rate>
2017-07-25 14:13:02 +00:00
OSD_NO_SORTBITWISE
__________________
2017-07-27 02:05:35 +00:00
No pre-luminous v12.y.z OSDs are running but the `` sortbitwise `` flag has not
been set.
The `` sortbitwise `` flag must be set before luminous v12.y.z or newer
OSDs can start. You can safely set the flag with::
ceph osd set sortbitwise
2017-07-25 14:13:02 +00:00
POOL_FULL
_________
2017-07-27 02:05:35 +00:00
One or more pools has reached its quota and is no longer allowing writes.
Pool quotas and utilization can be seen with::
ceph df detail
You can either raise the pool quota with::
ceph osd pool set-quota <poolname> max_objects <num-objects>
ceph osd pool set-quota <poolname> max_bytes <num-bytes>
or delete some existing data to reduce utilization.
2017-07-25 14:13:02 +00:00
2019-04-02 14:19:04 +00:00
BLUEFS_SPILLOVER
________________
One or more OSDs that use the BlueStore backend have been allocated
`db` partitions (storage space for metadata, normally on a faster
device) but that space has filled, such that metadata has "spilled
over" onto the normal slow device. This isn't necessarily an error
condition or even unexpected, but if the administrator's expectation
was that all metadata would fit on the faster device, it indicates
that not enough space was provided.
This warning can be disabled on all OSDs with::
ceph config set osd bluestore_warn_on_bluefs_spillover false
Alternatively, it can be disabled on a specific OSD with::
ceph config set osd.123 bluestore_warn_on_bluefs_spillover false
To provide more metadata space, the OSD in question could be destroyed and
reprovisioned. This will involve data migration and recovery.
It may also be possible to expand the LVM logical volume backing the
`db` storage. If the underlying LV has been expanded, the OSD daemon
needs to be stopped and BlueFS informed of the device size change with::
ceph-bluestore-tool bluefs-bdev-expand --path /var/lib/ceph/osd/ceph-$ID
2019-04-15 13:59:46 +00:00
BLUESTORE_LEGACY_STATFS
_______________________
In the Nautilus release, BlueStore tracks its internal usage
statistics on a per-pool granular basis, and one or more OSDs have
BlueStore volumes that were created prior to Nautilus. If *all* OSDs
are older than Nautilus, this just means that the per-pool metrics are
not available. However, if there is a mix of pre-Nautilus and
post-Nautilus OSDs, the cluster usage statistics reported by `` ceph
df`` will not be accurate.
The old OSDs can be updated to use the new usage tracking scheme by stopping each OSD, running a repair operation, and the restarting it. For example, if `` osd.123 `` needed to be updated,::
systemctl stop ceph-osd@123
ceph-bluestore-tool repair --path /var/lib/ceph/osd/ceph-123
systemctl start ceph-osd@123
This warning can be disabled with::
ceph config set global bluestore_warn_on_legacy_statfs false
BLUESTORE_DISK_SIZE_MISMATCH
____________________________
One or more OSDs using BlueStore has an internal inconsistency between the size
of the physical device and the metadata tracking its size. This can lead to
the OSD crashing in the future.
The OSDs in question should be destroyed and reprovisioned. Care should be
taken to do this one OSD at a time, and in a way that doesn't put any data at
risk. For example, if osd `` $N `` has the error,::
ceph osd out osd.$N
while ! ceph osd safe-to-destroy osd.$N ; do sleep 1m ; done
ceph osd destroy osd.$N
ceph-volume lvm zap /path/to/device
ceph-volume lvm create --osd-id $N --data /path/to/device
2017-07-25 14:13:02 +00:00
2018-07-31 14:22:42 +00:00
Device health
-------------
DEVICE_HEALTH
_____________
One or more devices is expected to fail soon, where the warning
threshold is controlled by the `` mgr/devicehealth/warn_threshold ``
config option.
This warning only applies to OSDs that are currently marked "in", so
the expected response to this failure is to mark the device "out" so
that data is migrated off of the device, and then to remove the
hardware from the system. Note that the marking out is normally done
automatically if `` mgr/devicehealth/self_heal `` is enabled based on
the `` mgr/devicehealth/mark_out_threshold `` .
Device health can be checked with::
ceph device info <device-id>
Device life expectancy is set by a prediction model run by
the mgr or an by external tool via the command::
ceph device set-life-expectancy <device-id> <from> <to>
You can change the stored life expectancy manually, but that usually
doesn't accomplish anything as whatever tool originally set it will
probably set it again, and changing the stored value does not affect
the actual health of the hardware device.
DEVICE_HEALTH_IN_USE
____________________
One or more devices is expected to fail soon and has been marked "out"
2018-08-09 20:51:25 +00:00
of the cluster based on `` mgr/devicehealth/mark_out_threshold `` , but it
2018-07-31 14:22:42 +00:00
is still participating in one more PGs. This may be because it was
only recently marked "out" and data is still migrating, or because data
cannot be migrated off for some reason (e.g., the cluster is nearly
full, or the CRUSH hierarchy is such that there isn't another suitable
OSD to migrate the data too).
This message can be silenced by disabling the self heal behavior
(setting `` mgr/devicehealth/self_heal `` to false), by adjusting the
`` mgr/devicehealth/mark_out_threshold `` , or by addressing what is
preventing data from being migrated off of the ailing device.
DEVICE_HEALTH_TOOMANY
_____________________
Too many devices is expected to fail soon and the
`` mgr/devicehealth/self_heal `` behavior is enabled, such that marking
out all of the ailing devices would exceed the clusters
`` mon_osd_min_in_ratio `` ratio that prevents too many OSDs from being
automatically marked "out".
This generally indicates that too many devices in your cluster are
expected to fail soon and you should take action to add newer
(healthier) devices before too many devices fail and data is lost.
The health message can also be silenced by adjusting parameters like
`` mon_osd_min_in_ratio `` or `` mgr/devicehealth/mark_out_threshold `` ,
but be warned that this will increase the likelihood of unrecoverable
data loss in the cluster.
2017-07-25 14:13:02 +00:00
Data health (pools & placement groups)
2017-08-02 07:35:29 +00:00
--------------------------------------
2017-07-25 14:13:02 +00:00
PG_AVAILABILITY
_______________
2017-08-01 13:25:27 +00:00
Data availability is reduced, meaning that the cluster is unable to
service potential read or write requests for some data in the cluster.
Specifically, one or more PGs is in a state that does not allow IO
requests to be serviced. Problematic PG states include *peering* ,
*stale* , *incomplete* , and the lack of *active* (if those conditions do not clear
quickly).
Detailed information about which PGs are affected is available from::
ceph health detail
In most cases the root cause is that one or more OSDs is currently
2018-08-09 20:51:25 +00:00
down; see the discussion for `` OSD_DOWN `` above.
2017-08-01 13:25:27 +00:00
The state of specific problematic PGs can be queried with::
ceph tell <pgid> query
2017-07-25 14:13:02 +00:00
PG_DEGRADED
___________
2017-08-01 13:25:27 +00:00
Data redundancy is reduced for some data, meaning the cluster does not
have the desired number of replicas for all data (for replicated
pools) or erasure code fragments (for erasure coded pools).
Specifically, one or more PGs:
* has the *degraded* or *undersized* flag set, meaning there are not
enough instances of that placement group in the cluster;
* has not had the *clean* flag set for some time.
Detailed information about which PGs are affected is available from::
ceph health detail
In most cases the root cause is that one or more OSDs is currently
down; see the dicussion for `` OSD_DOWN `` above.
The state of specific problematic PGs can be queried with::
ceph tell <pgid> query
2017-07-25 14:13:02 +00:00
PG_DEGRADED_FULL
________________
2017-08-01 13:25:27 +00:00
Data redundancy may be reduced or at risk for some data due to a lack
of free space in the cluster. Specifically, one or more PGs has the
*backfill_toofull* or *recovery_toofull* flag set, meaning that the
cluster is unable to migrate or recover data because one or more OSDs
is above the *backfillfull* threshold.
See the discussion for *OSD_BACKFILLFULL* or *OSD_FULL* above for
steps to resolve this condition.
2017-07-25 14:13:02 +00:00
PG_DAMAGED
__________
2017-08-01 13:25:27 +00:00
Data scrubbing has discovered some problems with data consistency in
the cluster. Specifically, one or more PGs has the *inconsistent* or
*snaptrim_error* flag is set, indicating an earlier scrub operation
found a problem, or that the *repair* flag is set, meaning a repair
for such an inconsistency is currently in progress.
See :doc: `pg-repair` for more information.
2017-07-25 14:13:02 +00:00
OSD_SCRUB_ERRORS
________________
2017-08-01 13:25:27 +00:00
Recent OSD scrubs have uncovered inconsistencies. This error is generally
2018-08-09 20:51:25 +00:00
paired with *PG_DAMAGED* (see above).
2017-08-01 13:25:27 +00:00
See :doc: `pg-repair` for more information.
2017-07-25 14:13:02 +00:00
2018-11-27 03:50:24 +00:00
LARGE_OMAP_OBJECTS
__________________
One or more pools contain large omap objects as determined by
`` osd_deep_scrub_large_omap_object_key_threshold `` (threshold for number of keys
to determine a large omap object) or
`` osd_deep_scrub_large_omap_object_value_sum_threshold `` (the threshold for
summed size (bytes) of all key values to determine a large omap object) or both.
More information on the object name, key count, and size in bytes can be found
by searching the cluster log for 'Large omap object found'. Large omap objects
can be caused by RGW bucket index objects that do not have automatic resharding
enabled. Please see :ref:`RGW Dynamic Bucket Index Resharding
<rgw_dynamic_bucket_index_resharding> ` for more information on resharding.
The thresholds can be adjusted with::
ceph config set osd osd_deep_scrub_large_omap_object_key_threshold <keys>
ceph config set osd osd_deep_scrub_large_omap_object_value_sum_threshold <bytes>
2017-07-25 14:13:02 +00:00
CACHE_POOL_NEAR_FULL
____________________
2017-08-01 13:25:27 +00:00
A cache tier pool is nearly full. Full in this context is determined
by the `` target_max_bytes `` and `` target_max_objects `` properties on
the cache pool. Once the pool reaches the target threshold, write
requests to the pool may block while data is flushed and evicted
from the cache, a state that normally leads to very high latencies and
poor performance.
The cache pool target size can be adjusted with::
ceph osd pool set <cache-pool-name> target_max_bytes <bytes>
ceph osd pool set <cache-pool-name> target_max_objects <objects>
Normal cache flush and evict activity may also be throttled due to reduced
availability or performance of the base tier, or overall cluster load.
2017-07-25 14:13:02 +00:00
TOO_FEW_PGS
___________
2017-08-01 13:25:27 +00:00
The number of PGs in use in the cluster is below the configurable
threshold of `` mon_pg_warn_min_per_osd `` PGs per OSD. This can lead
2018-08-09 20:51:25 +00:00
to suboptimal distribution and balance of data across the OSDs in
2018-12-02 22:43:43 +00:00
the cluster, and similarly reduce overall performance.
2017-08-01 13:25:27 +00:00
This may be an expected condition if data pools have not yet been
created.
2017-08-15 15:17:14 +00:00
The PG count for existing pools can be increased or new pools can be created.
Please refer to :ref: `choosing-number-of-placement-groups` for more
information.
2017-07-25 14:13:02 +00:00
2018-12-02 22:43:43 +00:00
POOL_TOO_FEW_PGS
________________
One or more pools should probably have more PGs, based on the amount
of data that is currently stored in the pool. This can lead to
suboptimal distribution and balance of data across the OSDs in the
cluster, and similarly reduce overall performance. This warning is
generated if the `` pg_autoscale_mode `` property on the pool is set to
`` warn `` .
To disable the warning, you can disable auto-scaling of PGs for the
pool entirely with::
ceph osd pool set <pool-name> pg_autoscale_mode off
To allow the cluster to automatically adjust the number of PGs,::
ceph osd pool set <pool-name> pg_autoscale_mode on
You can also manually set the number of PGs for the pool to the
recommended amount with::
ceph osd pool set <pool-name> pg_num <new-pg-num>
Please refer to :ref: `choosing-number-of-placement-groups` and
:ref: `pg-autoscaler` for more information.
2017-07-25 14:13:02 +00:00
TOO_MANY_PGS
____________
2017-08-01 13:25:27 +00:00
The number of PGs in use in the cluster is above the configurable
2017-09-14 20:01:14 +00:00
threshold of `` mon_max_pg_per_osd `` PGs per OSD. If this threshold is
exceed the cluster will not allow new pools to be created, pool `pg_num` to
be increased, or pool replication to be increased (any of which would lead to
more PGs in the cluster). A large number of PGs can lead
2017-08-01 13:25:27 +00:00
to higher memory utilization for OSD daemons, slower peering after
cluster state changes (like OSD restarts, additions, or removals), and
higher load on the Manager and Monitor daemons.
2017-09-14 20:01:14 +00:00
The simplest way to mitigate the problem is to increase the number of
OSDs in the cluster by adding more hardware. Note that the OSD count
used for the purposes of this health check is the number of "in" OSDs,
so marking "out" OSDs "in" (if there are any) can also help::
2017-08-01 13:25:27 +00:00
2017-09-14 20:01:14 +00:00
ceph osd in <osd id(s)>
2017-08-01 13:25:27 +00:00
2017-08-15 15:17:14 +00:00
Please refer to :ref: `choosing-number-of-placement-groups` for more
information.
2017-07-25 14:13:02 +00:00
2018-12-02 22:43:43 +00:00
POOL_TOO_MANY_PGS
_________________
One or more pools should probably have more PGs, based on the amount
of data that is currently stored in the pool. This can lead to higher
memory utilization for OSD daemons, slower peering after cluster state
changes (like OSD restarts, additions, or removals), and higher load
on the Manager and Monitor daemons. This warning is generated if the
`` pg_autoscale_mode `` property on the pool is set to `` warn `` .
To disable the warning, you can disable auto-scaling of PGs for the
pool entirely with::
ceph osd pool set <pool-name> pg_autoscale_mode off
To allow the cluster to automatically adjust the number of PGs,::
ceph osd pool set <pool-name> pg_autoscale_mode on
You can also manually set the number of PGs for the pool to the
recommended amount with::
ceph osd pool set <pool-name> pg_num <new-pg-num>
Please refer to :ref: `choosing-number-of-placement-groups` and
:ref: `pg-autoscaler` for more information.
POOL_TARGET_SIZE_RATIO_OVERCOMMITTED
____________________________________
One or more pools have a `` target_size_ratio `` property set to
estimate the expected size of the pool as a fraction of total storage,
but the value(s) exceed the total available storage (either by
themselves or in combination with other pools' actual usage).
This is usually an indication that the `` target_size_ratio `` value for
the pool is too large and should be reduced or set to zero with::
ceph osd pool set <pool-name> target_size_ratio 0
For more information, see :ref: `specifying_pool_target_size` .
POOL_TARGET_SIZE_BYTES_OVERCOMMITTED
____________________________________
One or more pools have a `` target_size_bytes `` property set to
estimate the expected size of the pool,
but the value(s) exceed the total available storage (either by
themselves or in combination with other pools' actual usage).
This is usually an indication that the `` target_size_bytes `` value for
the pool is too large and should be reduced or set to zero with::
ceph osd pool set <pool-name> target_size_bytes 0
For more information, see :ref: `specifying_pool_target_size` .
2019-04-26 07:15:11 +00:00
TOO_FEW_OSDS
____________
The number of OSDs in the cluster is below the configurable
threshold of `` osd_pool_default_size `` .
2017-07-25 14:13:02 +00:00
SMALLER_PGP_NUM
_______________
2017-08-01 13:25:27 +00:00
One or more pools has a `` pgp_num `` value less than `` pg_num `` . This
is normally an indication that the PG count was increased without
also increasing the placement behavior.
This is sometimes done deliberately to separate out the `split` step
when the PG count is adjusted from the data migration that is needed
when `` pgp_num `` is changed.
This is normally resolved by setting `` pgp_num `` to match `` pg_num `` ,
triggering the data migration, with::
ceph osd pool set <pool> pgp_num <pg-num-value>
2017-07-25 14:13:02 +00:00
MANY_OBJECTS_PER_PG
___________________
2017-08-01 13:25:27 +00:00
One or more pools has an average number of objects per PG that is
significantly higher than the overall cluster average. The specific
threshold is controlled by the `` mon_pg_warn_max_object_skew ``
configuration value.
This is usually an indication that the pool(s) containing most of the
data in the cluster have too few PGs, and/or that other pools that do
not contain as much data have too many PGs. See the discussion of
*TOO_MANY_PGS* above.
The threshold can be raised to silence the health warning by adjusting
2019-04-05 13:58:36 +00:00
the `` mon_pg_warn_max_object_skew `` config option on the managers.
2017-07-25 14:13:02 +00:00
2018-12-02 22:43:43 +00:00
2017-07-25 15:15:00 +00:00
POOL_APP_NOT_ENABLED
____________________
A pool exists that contains one or more objects but has not been
tagged for use by a particular application.
Resolve this warning by labeling the pool for use by an application. For
example, if the pool is used by RBD,::
rbd pool init <poolname>
If the pool is being used by a custom application 'foo', you can also label
via the low-level command::
ceph osd pool application enable foo
2017-08-15 15:51:25 +00:00
For more information, see :ref: `associate-pool-to-application` .
2017-07-25 15:15:00 +00:00
2017-07-25 14:13:02 +00:00
POOL_FULL
_________
2017-08-01 13:25:27 +00:00
One or more pools has reached (or is very close to reaching) its
quota. The threshold to trigger this error condition is controlled by
the `` mon_pool_quota_crit_threshold `` configuration option.
Pool quotas can be adjusted up or down (or removed) with::
ceph osd pool set-quota <pool> max_bytes <bytes>
ceph osd pool set-quota <pool> max_objects <objects>
2017-08-15 12:43:00 +00:00
Setting the quota value to 0 will disable the quota.
2017-07-25 14:13:02 +00:00
POOL_NEAR_FULL
______________
2017-08-01 13:25:27 +00:00
One or more pools is approaching is quota. The threshold to trigger
this warning condition is controlled by the
`` mon_pool_quota_warn_threshold `` configuration option.
Pool quotas can be adjusted up or down (or removed) with::
ceph osd pool set-quota <pool> max_bytes <bytes>
ceph osd pool set-quota <pool> max_objects <objects>
Setting the quota value to 0 will disable the quota.
2017-07-25 14:13:02 +00:00
OBJECT_MISPLACED
________________
2017-08-01 13:25:27 +00:00
One or more objects in the cluster is not stored on the node the
cluster would like it to be stored on. This is an indication that
data migration due to some recent cluster change has not yet completed.
Misplaced data is not a dangerous condition in and of itself; data
consistency is never at risk, and old copies of objects are never
removed until the desired number of new copies (in the desired
locations) are present.
2017-07-25 14:13:02 +00:00
OBJECT_UNFOUND
______________
2017-08-01 13:25:27 +00:00
One or more objects in the cluster cannot be found. Specifically, the
OSDs know that a new or updated copy of an object should exist, but a
copy of that version of the object has not been found on OSDs that are
currently online.
Read or write requests to unfound objects will block.
Ideally, a down OSD can be brought back online that has the more
recent copy of the unfound object. Candidate OSDs can be identified from the
peering state for the PG(s) responsible for the unfound object::
ceph tell <pgid> query
If the latest copy of the object is not available, the cluster can be
2017-08-15 15:51:25 +00:00
told to roll back to a previous version of the object. See
:ref: `failures-osd-unfound` for more information.
2017-07-25 14:13:02 +00:00
2017-11-23 09:34:52 +00:00
SLOW_OPS
________
2017-07-25 14:13:02 +00:00
2017-08-01 13:25:27 +00:00
One or more OSD requests is taking a long time to process. This can
be an indication of extreme load, a slow storage device, or a software
bug.
The request queue on the OSD(s) in question can be queried with the
following command, executed from the OSD host::
ceph daemon osd.<id> ops
A summary of the slowest recent requests can be seen with::
ceph daemon osd.<id> dump_historic_ops
The location of an OSD can be found with::
ceph osd find osd.<id>
2017-07-25 14:13:02 +00:00
PG_NOT_SCRUBBED
_______________
2017-08-01 13:25:27 +00:00
One or more PGs has not been scrubbed recently. PGs are normally
scrubbed every `` mon_scrub_interval `` seconds, and this warning
2019-01-15 20:12:39 +00:00
triggers when `` mon_warn_pg_not_scrubbed_ratio `` percentage of interval has elapsed
without a scrub since it was due.
2017-08-01 13:25:27 +00:00
PGs will not scrub if they are not flagged as *clean* , which may
happen if they are misplaced or degraded (see *PG_AVAILABILITY* and
*PG_DEGRADED* above).
You can manually initiate a scrub of a clean PG with::
ceph pg scrub <pgid>
2017-07-25 14:13:02 +00:00
PG_NOT_DEEP_SCRUBBED
____________________
2017-08-01 13:25:27 +00:00
One or more PGs has not been deep scrubbed recently. PGs are normally
2019-02-19 19:39:36 +00:00
scrubbed every `` osd_deep_scrub_interval `` seconds, and this warning
2019-01-15 20:12:39 +00:00
triggers when `` mon_warn_pg_not_deep_scrubbed_ratio `` percentage of interval has elapsed
without a scrub since it was due.
2017-08-01 13:25:27 +00:00
PGs will not (deep) scrub if they are not flagged as *clean* , which may
happen if they are misplaced or degraded (see *PG_AVAILABILITY* and
*PG_DEGRADED* above).
You can manually initiate a scrub of a clean PG with::
ceph pg deep-scrub <pgid>