8 pool(s) backfillfull health： HEALTH_ERR

admin

使用检查
! ]# r* ]2 k- N8 {$ }! D9 Z( Rceph osd status
6 f5 O8 _& m6 j% \, Z7 xid  host  userd   avail       wr ops  wr data   rb ops  rb data    state
3   mon2  1111  1111     0            0          0           0           backfillfull，exists,up
* y& E2 m, H: m/ Q) X2 h



1 o8 a" Y* q- L$ s
今天检查 CEPH 发现 有一个 OSD 接近要满了的状态.
, m8 W# S2 U! d+ T+ h[root@storage02-ib ~]# ceph osd status
4 h5 y0 I6 |, A, a, i8 J+----+----------------------------+-------+-------+--------+---------+--------+---------+------------------------+
4 s" w- {  Q. J' R. e. G& l| id |            host            |  used | avail | wr ops | wr data | rd ops | rd data |         state          |
! m/ ?: {! z' N( K# D+----+----------------------------+-------+-------+--------+---------+--------+---------+------------------------+
8 r  R6 ]# d  L6 X5 ]8 w6 n
( [/ d* H3 \7 r2 f| 8  | compute02| 1374G | 4214G |    0   |     0   |    0   |     0   |       exists,up        |
2 A- N8 D& h3 c& o, f| 9  | compute02| 2098G | 3490G |    0   |     0   |    0   |     0   |       exists,up        |
| 10 | compute02| 1715G | 3873G |    0   |     0   |    0   |     0   |       exists,up        |
| 13 |compute02|  172G | 13.7G |    0   |     0   |    0   |     0   | backfillfull,exists,up |

+----+----------------------------+-------+-------+--------+---------+--------+---------+------------------------+
# W3 f! U7 j  X' A情况如上, ceph osd status 命令可以发现 OSD 13 已经接近要满了的状态.
7 v7 K0 }; E$ L: Z% m5 i% w————————————————

! `# {! R! ^# K& g; j- r/ `

admin

ceph -s 命令也可以看见提示 1 backfillfull osd(s), 由于 OSD pool 没有指定与 OSD 的 map 关系, 所以默认所有OSD都承载这些 pool 的, 所以也提示了 5 pool(s) backfillfull.

之所以还会提示 objects misplaced 是因为之前维护替换了一块硬盘, 正在数据恢复中.

6 m" c) V9 p7 Y' _2 q由于这个满了的 OSD 正好是之前还没来得及下掉的 NVMe 存储, NVMe 想用做其他用途, 所以这次准备干脆把 NVMe 下掉了.
8 @' b. s( V" H; S( D. }/ F
下掉 13 - 20 这几个 NVMe 的 OSD, CEPH 会自动将数据平衡到其他 OSD 中. 所以我们只需要先 mark OSD out, 然后删除 OSD, 最后移除硬件即可.

$ u5 Z! s0 v/ S! x. B; Y在移除过程一定先提前计算好容量是否足够, 如果下掉过多 OSD 导致整体容量不足, 将会导致 OSD 趋近于满的情况, 会造成集群读写性能下降甚至完全不能读写.

) n4 V/ w9 L) V3 X8 R% I# Z在移除的过程中, 也会占用系统的磁盘 IO 和网络带宽, 因此如果是线上业务, 一定规划好移除时间, 避免影响业务.
) W- X6 h8 t' ?( {0 @3 ?
首先, 我们移除 OSD 13, 14 作为演示.
, W; w# \* x2 {) W! _1 S* C
8 S- h3 G; B1 p1 E! O: q[root@storage02-ib ~]# ceph osd out 13 14;
marked out osd.13 osd.14
  cluster:
: t" }. L* Y+ q0 J0 R    id:     0f7be0a4-2a05-4658-8829-f3d2f62579d2
    health: HEALTH_WARN
& W2 \" p& J4 T, q0 O& i            258661/4527742 objects misplaced (5.713%)
            Degraded data redundancy: 22131/4527742 objects degraded (0.489%), 3 pgs degraded

  ]! r, v9 U; @$ {3 E8 o  services:
0 P" Z6 |9 ]$ `/ u4 x* Y8 L5 Q    mon: 3 daemons, quorum storage01-ib,storage02-ib,storage03-ib
- X# y& ]0 l1 f9 b5 _$ N    mgr: storage01-ib(active), standbys: storage03-ib, storage02-ib
  w# f: I3 n& T& b- F    osd: 19 osds: 19 up, 11 in; 36 remapped pgs
    rgw: 2 daemons active

4 V, D- c& Y! ?  data:
    pools:   5 pools, 288 pgs
9 S, `1 ]6 C5 W: a: }7 ~. \    objects: 2.26 M objects, 8.6 TiB
    usage:   18 TiB used, 43 TiB / 61 TiB avail
    pgs:     22131/4527742 objects degraded (0.489%)
             258661/4527742 objects misplaced (5.713%)
3 [) u( V2 H+ a, a  Y             252 active+clean
             28  active+remapped+backfill_wait
. A9 N# `8 t0 R. G  N             5   active+remapped+backfilling
             2   active+undersized+degraded+remapped+backfill_wait
             1   active+undersized+degraded+remapped+backfilling
4 X  \# q9 F, Z6 W: l' F; w  ]
# b0 {3 E7 s9 v  io:
- @  m$ b" j! r' _9 |% R# F+ t' M+ h2 J    recovery: 90 MiB/s, 22 objects/s
! Q6 }" r% m9 g% y* b. s' N
可以看到提示 258661/4527742 objects misplaced, 22131/4527742 objects degraded, 这些都是正在自动调整的数据.
- ~- \) d1 S& k$ M6 s% K
; w' G% u& x3 }等待调整完毕后, 我们依次下掉其他的OSD即可.

- q- U, T' [7 T, i7 m$ a然后到对应的 OSD 的机器上, 停止相应的 OSD daemon.

admin

要以交互模式运行 ceph 工具，请不带任何自变量在命令行中键入 ceph。如果要在一行中输入多条 ceph 命令，则使用交互模式较为方便。例如：

cephadm > ceph

ceph> health

0 f% y& ^5 Z: O* H$ L2 q$ l9 U' T% gceph> status

: H% P9 s( L( P  t5 x: zceph> quorum_status
" _, B1 H6 V- ~6 i7 x
ceph> mon_status
( _7 s$ p; z3 @/ _+ O
( M2 O, Q" u! C0 S, i9 k. C& b4.1 检查集群运行状况

  F5 P; {% ]/ g- g- ~' \1 ]$ e在启动集群后到开始读取和/或写入数据期间，检查集群的运行状况：

root # ceph health

) j4 V! H2 T5 h1 E  a9 Z. cHEALTH_WARN 10 pgs degraded; 100 pgs stuck unclean; 1 mons down, quorum 0,2 \
' J0 v) u6 z% p
; r9 S' t2 _) f0 h2 G! a( o: D& d: p" rnode-1,node-2,node-3
+ E4 N# J. W, w* U1 j
Ceph 集群会返回下列运行状况代码之一：
5 F) o5 {* x- q) E
6 u- o* \/ s" E: a; J- Q! cOSD_DOWN

一个或多个 OSD 标记为已停机。OSD 守护进程可能已停止，或对等 OSD 可能无法通过网络连接 OSD。常见原因包括守护进程已停止或已崩溃、主机已停机或网络中断。
( r) t) \3 R/ t
校验主机是否运行良好，守护进程是否已启动，并且网络是否正常工作。如果守护进程已崩溃，守护进程日志文件 (/var/log/ceph/ceph-osd.*) 可能会包含调试信息。

5 {# y, Q9 A# c: o6 y2 yOSD_crush type_DOWN，例如 OSD_HOST_DOWN

7 ^) r0 G' Q7 s  ~特定 CRUSH 子树中的所有 OSD 均标记为已停机，例如主机上的所有 OSD。

- W8 [* t! @4 i$ d$ DOSD_ORPHAN

在 CRUSH 地图层次结构中引用了 OSD，但它不存在。可使用以下命令从 CRUSH 层次结构中删除 OSD：
8 h: N8 y5 I  o8 N
9 G* |  f4 t* o3 [; B$ Uroot # ceph osd crush rm osd.ID
/ h9 i# L6 _( L2 S9 Q
3 ]6 L6 C: ?' t1 M6 \4 sOSD_OUT_OF_ORDER_FULL

2 p8 V: _/ S1 s# B  J8 m( B" ebackfillfull、nearfull、full 和/或 failsafe_full 的用量阈值没有采用升序。特别是，我们需要 backfillfull < nearfull，nearfull < full 且 full < failsafe_full。可使用以下命令调整阈值：

root # ceph osd set-backfillfull-ratio ratio
0 U/ H: M) G& f1 Q5 c% g* d
7 j* c. s$ Y, I' c2 ~, M! l3 zroot # ceph osd set-nearfull-ratio ratio
$ Z  U$ Y3 [/ z! x, {, l7 ?% C5 n. @+ e
5 @8 [/ x! N; M+ `$ Yroot # ceph osd set-full-ratio ratio

9 P4 |/ M) t& {- M+ AOSD_FULL

一个或多个 OSD 超出了 full 阈值，阻止集群处理写入操作。可使用以下命令检查各存储池的用量：

" a: a; j  w7 Xroot # ceph df

可使用以下命令查看当前定义的 full 比例：
. a% a7 f5 p& `& \% {, M0 X
root # ceph osd dump | grep full_ratio
9 ~! }: k+ ^1 O& Z& ]
2 ]' I/ r* S7 a2 t- a9 H6 [4 R% x恢复写入可用性的临时解决方法是稍稍提高 full 阈值：
' _7 n" b7 z- z2 d5 ~( Y
root # ceph osd set-full-ratio ratio

请通过部署更多 OSD 将新的存储添加到集群，或者删除现有数据来腾出空间。
4 H5 O2 u# J* I; E6 c  z2 |
1 y* L2 k) ]$ [OSD_BACKFILLFULL

7 _/ \6 P5 x0 {/ l) g一个或多个 OSD 超出了 backfillfull 阈值，因而不允许将数据重新平衡到此设备。这是一条预警，意味着重新平衡可能无法完成，并且集群将满。可使用以下命令检查各存储池的用量：

root # ceph df
1 S- A  J, k: E2 H# T( k, `/ m
OSD_NEARFULL

$ M* E: ?: I* I一个或多个 OSD 超出了 nearfull 阈值。这是一条预警，意味着集群将满。可使用以下命令检查各存储池的用量：

root # ceph df
0 ^1 J  b  I! Q
OSDMAP_FLAGS
! C* B  s" C! U# N
已设置一个或多个所需的集群标志。可使用以下命令设置或清除这些标志（full 除外）：
  ~/ ?0 r1 M3 G& D
root # ceph osd set flag

/ c4 e& q" C. ~0 p# ~3 b+ }root # ceph osd unset flag
! Q& W, v; _9 U, l$ `
这些标志包括：
* l; q/ q' a! K( e
full
) h3 |3 q( q1 h: g) V
) Q4 Y+ h% T" Q+ _" ~0 M" c! ~集群标记为已满，无法处理写入操作。

pauserd、pausewr
4 [- Y  ?& x& M3 \* l. N
7 K6 v8 w3 e& R  h已暂停读取或写入。

$ g4 l9 f0 u# |, o6 m6 R2 }noup
9 B0 B5 h+ l- E1 l
不允许 OSD 启动。

0 D- v7 k+ N) dnodown

将会忽略 OSD 故障报告，如此监视器便不会将 OSD 标记为 down。
' Z" j, }' k/ O  ]
noin

, Q/ c7 m( H/ V$ O# z先前标记为 out 的 OSD 在启动时将不会重新标记为 in。
$ w$ a1 k: M$ e; n0 \0 V! t, ]
noout

7 E+ p% }4 K" c3 S$ J9 e0 C停机的 OSD 在配置间隔过后将不会自动标记为 out。
- [/ w+ j6 R+ Q3 @* H2 w
nobackfill、norecover、norebalance
+ x3 q# \0 c$ Q. b/ h& _
恢复或数据重新平衡进程已暂停。
5 q, J( U( a# u$ N0 H) p& D$ o
noscrub、nodeep_scrub
; W* }8 Z8 v! m. G  j! @
整理 (scrub) 进程已禁用（请参见第 6.5 节 “整理 (Scrub)”）。
5 q) `3 U2 e; Q
notieragent

$ m. n; d4 b/ k  R+ x2 ]6 B快速缓存分层活动已暂停。

OSD_FLAGS
2 P9 n! L, m& o+ K7 |# v7 h% Z
一个或多个 OSD 设置了所需的每 OSD 标志。这些标志包括：
6 w" k1 c/ e3 W' Y+ t3 A4 h2 R' {
4 x6 F! o. s0 h0 ^; @* K/ snoup
7 C$ S) q- V* D/ Z# e4 d
9 Y# V# `8 K6 R不允许 OSD 启动。
6 T; a- ~8 @9 h# V& S
nodown

将会忽略此 OSD 的故障报告。

- Q6 y4 P! C9 E" ?/ b; y; xnoin
4 L- X( O  `! {1 R5 E% Q) B  p
1 F& a+ W& i& A0 Z3 V% |- Z如果此 OSD 先前在发生故障后自动标记为 out，当它启动时将不会标记为 in。
. K. D2 B" q4 M: s( h; @
noout

如果此 OSD 已停机，则在配置的间隔过后，它将不会自动标记为 out。

可使用以下命令来设置和清除每 OSD 标志：
) g" O" @  z8 X& @, v# L% ~; j+ }
' L5 e$ l4 f, _7 z5 S4 mroot # ceph osd add-flag osd-ID

, ^# C& r) P- E$ \5 @& J, I* H( ?4 M7 Broot # ceph osd rm-flag osd-ID
' E4 z, B( O6 |
OLD_CRUSH_TUNABLES
* B1 n2 h: ~/ T2 n; @# F3 H
/ ]# a0 i) o$ M: d  o! W5 [CRUSH 地图目前使用的设置很旧，应予以更新。mon_crush_min_required_version 配置选项可确定使用时不会触发此运行状况警告的最旧可调变量（即能够连接到集群的最旧客户端版本）。

OLD_CRUSH_STRAW_CALC_VERSION

, {) L" I, z( f5 q/ i8 LCRUSH 地图目前使用较旧的非最佳方法来计算 straw 桶的中间权重值。应该更新 CRUSH 地图以使用较新的方法 (straw_calc_version=1)。

% X2 M4 j$ R0 XCACHE_POOL_NO_HIT_SET

4 b7 ]2 N* |7 A2 T+ F1 P  }# t一个或多个快速缓存池未配置命中集来跟踪用量，这使分层代理无法识别要从快速缓存中清理和逐出的冷对象。可使用以下命令对快速缓存池配置命中集：
' O' N2 l% }1 F9 j- q
, i  o/ G4 [. u  Hroot # ceph osd pool set poolname hit_set_type type

- K) \; J, N* `root # ceph osd pool set poolname hit_set_period period-in-seconds
" _7 c+ H% n% i5 t# p+ P
+ m/ ~9 Y( M0 h, c0 ^root # ceph osd pool set poolname hit_set_count number-of-hitsets

root # ceph osd pool set poolname hit_set_fpp target-false-positive-rate
8 T2 K8 j: I: ~3 ~) k' ?# R& l  P
OSD_NO_SORTBITWISE
# z3 _; z2 l/ {: z8 H9 r" g
  t% {$ E4 w+ ^' @+ u$ X未在运行早于 Luminous 12 版本的 OSD，但是尚未设置 sortbitwise 标志。您需要先设置 sortbitwise 标志，Luminous 12 或更新版本的 OSD 才能启动：

root # ceph osd set sortbitwise
: \% U. V. f) r- e. _
' y) N' d( y+ j/ |4 sPOOL_FULL

2 i% e, F- w* }一个或多个存储池已达到其配额，不再允许写入。可使用以下命令设置存储池配额和用量：

- L7 v& ]8 v) r, j- iroot # ceph df detail

5 v' x, O* G* |- D/ m您可以使用以下命令提高存储池配额

& A( I7 p0 P, F2 K+ U- Y1 A3 nroot # ceph osd pool set-quota poolname max_objects num-objects
; k8 K( B7 J2 M1 H
1 G& V# ~0 q  B, h7 Z# [( a; `root # ceph osd pool set-quota poolname max_bytes num-bytes
9 Y- v1 b9 _# A& m& D
或者删除一些现有数据以减少用量。
4 A5 i5 J0 t4 ~. ]0 Y, `
PG_AVAILABILITY

数据可用性下降，这意味着集群无法处理针对集群中某些数据的潜在读取或写入请求。具体而言，一个或多个 PG 处于不允许处理 IO 请求的状态。有问题的 PG 状态包括连接建立中、不新鲜、不完整和不活跃（如果这些状况不迅速解决）。运行以下命令可获得有关哪些 PG 受影响的详细信息：
! @, N5 T$ h& a/ K9 |" G
root # ceph health detail
* Q1 c2 q5 R% d9 R" L3 o3 m
: f+ u9 f0 g6 O% M大多数情况下，出现此情形的根本原因在于一个或多个 OSD 当前已停机。可使用以下命令查询特定的有问题 PG 的状态：

  }1 \$ N0 s" F# m1 i+ ^root # ceph tell pgid query

3 g4 D9 a# s* I% L- L1 I2 Y# WPG_DEGRADED

( C9 U+ V8 V& n# N& h某些数据的数据冗余降低，这意味着集群没有所需数量的副本用于所有数据（对于副本池）或纠删码分段（对于纠删码池）。具体而言，一个或多个 PG 设置了 degraded 或 undersized 标志（集群中没有该归置组的足够实例），或者有一段时间未设置 clean 标志。运行以下命令可获得有关哪些 PG 受影响的详细信息：
% t' }9 G+ G4 _; v
root # ceph health detail
( R1 A7 ]  Y# h5 B
大多数情况下，出现此情形的根本原因在于一个或多个 OSD 当前已停机。可使用以下命令查询特定的有问题 PG 的状态：

6 F  b/ |5 J) }! y4 y* g1 Mroot # ceph tell pgid query

PG_DEGRADED_FULL
7 M1 [1 Q+ a9 {( B$ Q5 D
! Y) \# l6 _: W6 {3 a由于集群中的可用空间不足，某些数据的数据冗余可能已降低或面临风险。具体而言，一个或多个 PG 设置了 backfill_toofull 或 recovery_tooful 标志，这意味着集群无法迁移或恢复数据，原因是一个或多个 OSD 高于 backfillfull 阈值。

PG_DAMAGED
5 j& ~  z7 X" Y. X# U, R# t
数据整理 (scrub)（请参见第 6.5 节 “整理 (Scrub)”）进程发现集群中存在某些数据一致性问题。具体而言，一个或多个 PG 设置了 inconsistent 或 snaptrim_error 标志（表示某个较早的整理操作发现问题），或者设置了 repair 标志（表示当前正在修复此类不一致问题）。

0 K, F  W+ C3 J2 vOSD_SCRUB_ERRORS
+ @5 u/ c+ w% Y/ k9 Q
最近的 OSD 整理 (scrub) 操作发现了不一致问题。
& u, ^1 q4 p4 D2 W' |
CACHE_POOL_NEAR_FULL
  q) T! A) x. o* `2 ~3 C5 i% R
快速缓存层池将满。在此环境中，“满”由快速缓存池的 target_max_bytes 和 target_max_objects 属性确定。池达到目标阈值时，如果正在从快速缓存清理并逐出数据，写入池的请求可能会被阻止，出现常会导致延迟很高且性能变差的状态。可使用以下命令调整快速缓存池目标大小：
$ g: j1 R0 A9 P2 a# D5 S# ^
root # ceph osd pool set cache-pool-name target_max_bytes bytes
5 }* M& N3 @9 n" Z& v! M2 w
root # ceph osd pool set cache-pool-name target_max_objects objects
7 ^, O6 p: D5 [* I7 w0 T1 J7 d
正常的快速缓存清理和逐出活动还可能因基础层可用性或性能下降或者集群的整体负载较高而受到限制。

9 P" H4 s% n, CTOO_FEW_PGS

使用中的 PG 数量低于每个 OSD 的 PG 数的可配置阈值 mon_pg_warn_min_per_osd。这可能导致集群中各 OSD 间的数据分布和平衡未达到最佳，以致降低整体性能。
, }0 U1 E/ Q' E# |8 ^" D
TOO_MANY_PGS
- ]. Y! j( t- U( ^: H( I
: D, c! c% H) t" A5 u使用中的 PG 数量高于每个 OSD 的 PG 数的可配置阈值 mon_pg_warn_max_per_osd。这可能导致 OSD 守护进程的内存用量较高，集群状态更改（例如 OSD 重启动、添加或删除）之后建立连接速度降低，并且 Ceph manager 和 Ceph monitor 上的负载较高。

4 ^, C$ ?' m1 h! m8 j- j/ @虽然不能降低现有存储池的 pg_num 值，但是可以降低 pgp_num 值。这样可有效地在同组 OSD 上并置一些 PG，从而减轻上述的一些负面影响。可使用以下命令调整 pgp_num 值：

' Z6 y+ r: D4 s/ }root # ceph osd pool set pool pgp_num value
: e4 d- D; O; |7 y( Z) |
SMALLER_PGP_NUM

& U" L$ b# V! y% {一个或多个存储池的 pgp_num 值小于 pg_num。这通常表示 PG 计数有所提高，但未同时提升归置行为。使用以下命令设置 pgp_num，使其与触发数据迁移的 pg_num 相匹配，通常便可解决此问题：

9 o+ E; b5 N: l' }1 yceph osd pool set pool pgp_num pg_num_value

MANY_OBJECTS_PER_PG

一个或多个存储池的每 PG 平均对象数大大高于集群的整体平均值。该特定阈值通过 mon_pg_warn_max_object_skew 配置值控制。这通常表示包含集群中大部分数据的存储池具有的 PG 太少，以及/或者不包含这么多数据的其他存储池具有的 PG 太多。可通过调整监视器上的 mon_pg_warn_max_object_skew 配置选项提高阈值，来消除该运行状况警告。

0 z$ S3 X9 Q# U/ CPOOL_APP_NOT_ENABLED

5 b4 i/ a8 @0 Z1 p9 E. L, k) g存在包含一个或多个对象但尚未标记为供特定应用使用的存储池。将存储池标记为供某个应用使用即可消除此警告。例如，如果存储池由 RBD 使用：
8 j# F! \$ s5 H; U: B7 h& q% p
root # rbd pool init pool_name
, G& j, G5 |, l1 T; H6 Y" _
如果存储池正由自定义应用“foo”使用，您还可以使用低级别命令标记它：
/ |! N! R( w% [$ {% K; P
root # ceph osd pool application enable foo
' r5 `% P4 M2 I8 N& i- O& J
POOL_FULL
0 W0 w$ H$ m# h
" r; Q$ A3 A. u9 R, w; I一个或多个存储池已达到（或几乎要达到）其配额。触发此错误状况的阈值通过 mon_pool_quota_crit_threshold 配置选项控制。可使用以下命令上调、下调（或删除）存储池配额：

root # ceph osd pool set-quota pool max_bytes bytes
0 j+ x/ z& E* M- X! r: c
root # ceph osd pool set-quota pool max_objects objects
( X% {. y# g6 Q; D* H* M' B7 q
# l* i% H4 ^! V  \& S  l& @7 p将配额值设置为 0 将禁用配额。
. S* u' [9 ^* V  \* P" }, }- {9 R# S
& K, M+ B3 g3 u' L  SPOOL_NEAR_FULL

一个或多个存储池接近其配额。触发此警告状况的阈值通过 mon_pool_quota_warn_threshold 配置选项控制。可使用以下命令上调、下调（或删除）存储池配额：
- m  ~: I0 Q* v
root # ceph osd osd pool set-quota pool max_bytes bytes
' @6 x1 k2 P2 L7 R. n4 T* J2 x' l! S
2 N6 P# j. }( ^0 p% O3 f9 h0 {( nroot # ceph osd osd pool set-quota pool max_objects objects

* M7 S7 Y/ `+ \) h3 a8 g5 y将配额值设置为 0 将禁用配额。

OBJECT_MISPLACED
' L0 K3 z( K9 {/ j  j; l5 {
集群中的一个或多个对象未存储在集群希望用于存储这些对象的节点上。这表示集群最近的某项更改导致的数据迁移尚未完成。误放的数据本质上不属于危险状况。数据一致性方面永远不会有风险，仅当所需位置放置了对象所需份数的新副本之后，系统才会删除对象的旧副本。
5 f5 K2 A1 ~% o' s7 V: l
OBJECT_UNFOUND

找不到集群中的一个或多个对象。具体而言，OSD 知道对象的新副本或已更新副本应该存在，但当前在线的 OSD 上找不到该版本的对象副本。系统将阻止对“未找到”对象的读取和写入请求。理想情况下，系统可将具有未找到对象的最近副本的已停机 OSD 恢复在线状态。可通过负责处理未找到对象的 PG 的互联状态识别候选 OSD：
0 ~: E- b' k& A- i
root # ceph tell pgid query

4 @$ x" l3 ~. h% C2 \3 B4 f. ^REQUEST_SLOW
, w& Z+ |- [4 ~( p
正花费很长的时间处理一个或多个 OSD 请求。这可能表示负载极重、存储设备速度缓慢或有软件错误。可以从 OSD 主机执行以下命令来查询有问题的 OSD 上的请求队列：

+ Q) D9 d! Y* g1 f3 L/ [1 Wroot # ceph daemon osd.id ops

可以查看近期最慢的请求摘要：

9 P" k9 B  e) q- t: ^. j: I9 yroot # ceph daemon osd.id dump_historic_ops

可使用以下命令查找 OSD 的位置：

1 c) ]- W0 X9 z  L( l- A3 G  Vroot # ceph osd find osd.id

9 ^  h- r9 @  p5 v+ ^7 l- l* WREQUEST_STUCK

: x. F: B' T$ k0 E已将一个或多个 OSD 请求阻止了很长时间。这表示集群很长一段时间运行状况不佳（例如没有足够的运行中 OSD），或 OSD 存在一些内部问题。

5 U1 j% V. a% D  E! _* }PG_NOT_SCRUBBED
( ?. A* v8 N! I$ {$ o' F( Q
- F4 ^% g7 M4 E" N最近未整理 (scrub)（请参见第 6.5 节 “整理 (Scrub)”）一个或多个 PG。通常每 mon_scrub_interval 秒整理 (scrub) 一次 PG，当 mon_warn_not_scrubbed 这类间隔已过但未进行整理 (scrub) 时，就会触发此警告。如果 PG 未标记为清理，系统将不会整理 (scrub) 它们。如果 PG 放置错误或已降级，就会出现这种情况（请参见上文中的 PG_AVAILABILITY 和 PG_DEGRADED）。您可以使用以下命令手动对标记为清理的 PG 启动整理 (scrub)：
5 ^6 ~8 I0 [- G& p! ]5 g/ e
9 y$ P' e' Q  Q. A4 G0 L. r0 qroot # ceph pg scrub pgid
: I4 d4 F" L1 l& t9 y4 M
, w) u% d  |4 Y6 P3 r6 p( zPG_NOT_DEEP_SCRUBBED

' ^- i1 z% t, p. y+ L2 ]最近未深层整理 (deep scrub)（请参见第 6.5 节 “整理 (Scrub)”）一个或多个 PG。通常每 osd_deep_scrub_interval 秒整理 (scrub) 一次 PG，当 mon_warn_not_deep_scrubbed 这类间隔已过但未进行整理 (scrub) 时，就会触发此警告。如果 PG 未标记为清理，系统将不会（深层）整理 (scrub) 它们。如果 PG 放置错误或已降级，就会出现这种情况（请参见上文中的 PG_AVAILABILITY 和 PG_DEGRADED）。您可以使用以下命令手动对标记为清理的 PG 启动整理 (scrub)：
+ Q, L( l$ C# J9 P

admin

root # ceph pg deep-scrub pgid
  c% E. |7 Z9 \" @# B: y0 \& \, p
! C# Y- s4 j* O+ `

提示
6 S  N' m$ }( [! F: S8 N
如果之前为您的配置或密钥环指定了非默认位置，则此时可以指定它们的位置：

root # ceph -c /path/to/conf -k /path/to/keyring health

4.2 监视集群

可以使用 ceph -s 了解集群的即时状态。例如，由一个监视器和两个 OSD 组成的微型 Ceph 集群可在某工作负载正在运行时列显以下内容：
( `1 n8 W7 g. i1 M
% l" }" s; t' W& xcluster:
! I% ^, k: K' @9 _- A& O6 e
9 N  ^' i7 E  E2 r6 o* F  \/ D  id:     6586341d-4565-3755-a4fd-b50f51bee248

  health: HEALTH_OK



. }/ J7 P$ b4 f1 K) j% w( Dservices:
& l% X* J8 O2 j! _& X) k6 H' B
5 \/ z% m# u& p$ c, \" ~* |' [  mon: 3 daemons, quorum blueshark1,blueshark2,blueshark3
9 D2 g, e5 D/ G- e, d( h
  mgr: blueshark3(active), standbys: blueshark2, blueshark1

4 z+ l- ]- G" c' q: C  osd: 15 osds: 15 up, 15 in

0 [2 I( j+ H/ J/ G! C0 a* P
, [0 A+ I3 T+ g) B$ H
5 M2 f7 w5 t0 v1 `0 Y1 u/ t( K. |1 bdata:

. i; P4 g/ u* D4 ^  W9 H9 k/ k/ z: z: Z  pools:   8 pools, 340 pgs
( K1 I$ @8 ], r% n
  objects: 537 objects, 1985 MB
& W# Q: q4 B* `
  usage:   23881 MB used, 5571 GB / 5595 GB avail

* ^" h; b: |0 Q- l2 z  pgs:     340 active+clean
- P  r  {- {, _# l/ B" M& ?
: }7 A0 ?3 N; d- Y" H
9 j% m$ s* `8 i3 g" E
  Y5 A0 E2 N2 U/ Dio:
% f" l$ J5 E) r0 C" p/ z
# _% S% q* P! O  n/ h& K6 q8 x  client:   100 MB/s rd, 26256 op/s rd, 0 op/s wr

% B& k% N& ~6 c# q$ g+ s2 h4 W% w输出内容提供了以下信息：
$ C4 ~9 a$ A2 i0 L' j( C
集群 ID
* A! k! A' G: o2 R7 W集群运行状况
  S) }$ a( O- t# e监视器地图版本号和监视器仲裁的状态
; }) y: x' o4 f8 pOSD 地图版本号和 OSD 的状态
归置组地图版本
8 f* Z+ ?2 ?; a2 `- n8 W" \4 q: o归置组和存储池数量
0 i& ?* K3 e/ w4 p; H所存储数据理论上的数量和所存储对象的数量；以及
& A. g7 N, l8 s5 [所存储数据的总量。


提示：Ceph 计算数据用量的方式

, W4 r7 \# l# n9 S( A/ \used 值反映实际使用的原始存储量。xxx GB / xxx GB 值表示集群的可用容量（两者中较小的数字），以及集群的整体存储容量。理论数量反映在复制、克隆所存储数据或创建其快照前这些数据的大小。因此，实际存储的数据量通常会超出理论上的存储量，因为 Ceph 会创建数据的副本，可能还会将存储容量用于克隆和创建快照。

- c; |) R# q: W% \3 i4 U' H* d, W显示即时状态信息的其他命令如下：

ceph pg stat
, d5 @1 e+ s1 O; x2 K+ j( Y, dceph osd pool stats
ceph df
* _  f8 b+ Z; {( ~3 h0 w- zceph df detail
要获得实时更新的信息，请将以上任何命令（包括 ceph -s）放置在等待循环中，例如：

root # while true ; do ceph -s ; sleep 10 ; done
" Z  F! N" H! r1 y3 `8 G+ x) Q
如果您看累了，请按 Ctrl–C。

7 R/ ]3 u) o( Z4 a% N4.3 检查集群的用量统计数字
* S' O- t8 ?' s0 B
* c& m: e) C/ g0 C6 e( O% B& g; s要检查集群的数据用量和在各存储池中的数据分布，可以使用 df 选项。它类似于 Linux df。执行以下命令：
% t$ h/ O/ C3 D& t7 M- ]
root # ceph df

GLOBAL:
- H$ V# S) @8 {
    SIZE       AVAIL      RAW USED     %RAW USED
: Y: K/ e/ ~5 }% x
$ u0 Y6 a. a* j2 y    55886G     55826G       61731M          0.11

8 A) u- x  B% Q  k# ]POOLS:
! O+ ]8 J( `1 W' Q" m0 b3 c- k) p
    NAME         ID     USED      %USED     MAX AVAIL     OBJECTS

4 R1 {" a) f* `2 c$ s    testpool     1          0         0        17676G           0

    ecpool       2      4077M      0.01        35352G        2102

7 n; _3 P) F; H0 w    test1        3          0         0        17676G           0

    rbd          4         16         0        17676G           3
" V' O" [  G& r$ u; i, q' d! r# G# h
    rbd1         5         16         0        17676G           3

* t% u9 J& O: v+ Q- Z    ecpool1      6      5708M      0.02        35352G        2871

& \0 A6 i* m0 q5 \. d输出内容的 GLOBAL 段落提供集群用于数据的存储量概览。
9 z% C0 P! z' O, D  B
SIZE：集群的整体存储容量。
AVAIL：集群中可以使用的可用空间容量。
RAW USED：已用的原始存储量。
% RAW USED：已用的原始存储量百分比。将此数字与 full ratio 和 near full ratio 搭配使用，可确保您不会用完集群的容量。有关其他详细信息，请参见存储容量。

- c+ J, f8 U% ~7 T0 Q" q
- L/ ^0 y; ?& @" y- g3 |; f$ o( v注意：集群填充程度
. h+ {( h  F, g7 d
原始存储填充程度达到 70% - 80%，表示需要向集群添加新的存储。较高的用量可能导致单个 OSD 填满，集群处于不良运行状况。

使用命令 ceph osd df tree 可列出所有 OSD 的填充程度。
5 d  m& l) p9 R
0 R& @& R$ h: B8 a输出内容的 POOLS 段落提供了存储池列表和每个存储池的理论用量。此段落的输出不反映副本、克隆数据或快照。例如，如果您存储含 1MB 数据的对象，理论用量将是 1MB，但是根据副本、克隆数据或快照数量，实际用量可能是 2MB 或更多。

9 O! ~: {" {4 a/ cNAME：存储池的名称。
7 Q  U/ J8 V/ q) N. t! T1 V7 a) qID：存储池 ID。
USED：以千字节 (KB) 为单位的理论已存储数据量，如果该数字附加了 M，则以兆字节为单位，如果附加了 G，则以千兆字节为单位。
%USED：每个存储池的理论已用存储百分比。
MAX AVAIL：给定存储池中的最大可用空间。
OBJECTS：每个存储池的理论已存储对象数。


) ]! e( e% t2 U/ ~; {- v) c9 E1 g注意

" \' `+ o3 d0 H3 h5 |$ ?' Q& U2 xPOOLS 段落中的数字是理论上的。它们不包括副本、快照或克隆数量。因此，USED 和 %USED 数量之和不会加总到输出内容 %GLOBAL 段落中的 RAW USED 和 %RAW USED 数量中。

4.4 检查集群的状态
3 L. o# X# l% }  ]2 G
要检查集群的状态，请执行以下命令：
) I" L0 s) C/ K! t. o( \. V5 A
$ k6 r" C/ k# [0 _2 t# K( eroot # ceph status
7 {+ Y  ~$ m. K+ A( ~; a3 x8 y
或者
, A3 g) y$ c1 U2 [) B4 ~4 y' `
root # ceph -s
9 _  A+ `- |+ F+ ?& T' U' N: _* T
! }7 ]6 L: H: z5 _  ]3 ?, \% J在交互模式下，键入 status，然后按 Enter。

! P  O& j: X1 Q- Lceph> status
! G: y: {1 _5 F8 V
Ceph 将列显集群状态。例如，由一个监视器和两个 OSD 组成的微型 Ceph 集群可能会列显以下内容：

cluster b370a29d-9287-4ca3-ab57-3d824f65e339

/ l9 ?4 Y! y8 _- O1 E3 c' y: a health HEALTH_OK
- u& K. K( Z! @3 q% G4 j
monmap e1: 1 mons at {ceph1=10.0.0.8:6789/0}, election epoch 2, quorum 0 ceph1

" I( X  t' d( G- s& ]" h6 e osdmap e63: 2 osds: 2 up, 2 in
! u  S3 |6 i1 ]+ E8 X/ |- {) \
  pgmap v41332: 952 pgs, 20 pools, 17130 MB data, 2199 objects
  x- N) ~* g- D; w8 Q- ^
& x5 u! O- ~' m1 Z$ K        115 GB used, 167 GB / 297 GB avail
/ t5 f; L3 r7 Q+ c9 M, f6 c' \
. I4 m$ C! M" R5 m               1 active+clean+scrubbing+deep
9 s: V( R5 `' @* `2 ?  Y
             951 active+clean

$ X9 x3 r# ]  o' h4.5 检查 OSD 状态

; F8 I7 Q/ ^! h8 J6 t  G可通过执行以下命令来检查 OSD，以确保它们已启动且正在运行：
6 n8 z" U) l3 R# d$ t4 y+ L# K* a
! a9 r- `0 Y' D, }% |root # ceph osd stat

+ P! G/ I+ i9 `8 L" n8 h( u8 L或者

) U- S' O1 ]' }3 j& b" u# D( Groot # ceph osd dump
: ~1 N+ f. I: j* H
还可以根据 OSD 在 CRUSH 地图中的位置查看 OSD。

3 X& V0 z8 Z- c) croot # ceph osd tree
: z0 |# x: Y+ j" p6 `% |7 B
Ceph 将列显 CRUSH 树及主机、它的 OSD、OSD 是否已启动及其权重。

% ~4 _% w% |9 U# id    weight  type name       up/down reweight
% \9 ~  T; N1 x
-1      3       pool default
* v' _7 A9 m$ g- W; ?% W7 c
-3      3               rack mainrack

-2      3                       host osd-host
8 B7 I2 E  f; U; t9 ^; ?
0       1                               osd.0   up      1
' }9 S! b' a1 P5 a; w9 u) d
: O; X+ _+ h/ m! G4 |1       1                               osd.1   up      1

2       1                               osd.2   up      1

4.6 检查填满的 OSD
' @% F& {. x, |0 N
- D8 l1 c; N, I/ d0 rCeph 可阻止您向填满的 OSD 写入数据，以防丢失数据。在正常运行的集群中，当集群接近其填满比例时，您会收到警告。mon osd full ratio 默认设为容量的 0.95 (95%)，达到该比例后，集群会阻止客户端写入数据。mon osd nearfull ratio 默认设为容量的 0.85 (85%)，达到该比例时，集群会生成运行状况警告。
3 `! o4 b6 Y- r8 j
4 O& D% s' A5 q' B可通过 ceph health 命令报告填满的 OSD 节点：

ceph health

  HEALTH_WARN 1 nearfull osds

  osd.2 is near full at 85%
- T% g% _. S) |5 t3 \2 R* _1 q
或者

ceph health

5 n& r$ I  n% ?+ T7 P2 Z. c  HEALTH_ERR 1 nearfull osds, 1 full osds
3 y+ A4 u9 \4 d3 S# ]% g+ c& s
  osd.2 is near full at 85%

9 f+ o  |: x9 R& `' J  osd.3 is full at 97%

/ I9 k& A3 f1 c0 k处理填满的集群的最佳方法是添加新的 OSD 节点，以让集群将数据重新分布到新的可用存储。

如果 OSD 因填满而无法启动，您可以通过删除已满 OSD 中的一些归置组目录来删除一些数据。

0 K1 y) ]0 o" P2 Z- h1 M7 ^
1 r9 ^. E& x# @5 X8 Y2 i/ a
5 K$ {' N9 C$ I+ i' }$ Q提示：防止 OSD 填满

) @/ H3 D  k* U/ _( v1 G! hOSD 变满（即用完 100% 的磁盘空间）之后，往往会迅速崩溃而不发出警告。管理 OSD 节点时需记住下面几点提示。
! m1 x* z" |5 h; N
1 v" I$ L% @9 I3 f9 W每个 OSD 的磁盘空间（通常挂载在 /var/lib/ceph/osd/osd-{1,2..} 下）需放置在专用的底层磁盘或分区上。
3 o  [2 e5 H7 F检查 Ceph 配置文件，确保 Ceph 不会将其日志文件存储在专供 OSD 使用的磁盘/分区上。
确保没有其他进程写入专供 OSD 使用的磁盘/分区。
" z! L0 V$ t. c% n4.7 检查监视器状态

如果集群有多个监视器（这是很有可能的），则应在启动集群之后到读取和/或写入数据之前的期间检查监视器仲裁状态。有多个监视器在运行时，仲裁必须存在。您还应该定期检查监视器状态，确保它们正在运行。
7 @- D1 Q$ x/ K; m! N
要显示监视器地图，请执行以下命令：

& c. l4 p3 A* b6 K1 [root # ceph mon stat

或者
- `/ ~% }7 u. d  d% j
root # ceph mon dump
# ?- i" D: ^% S& u% r. m
# n$ [! D/ {6 }& {要检查监视器集群的仲裁状态，请执行以下命令：

+ k0 C* R+ A8 N7 f3 G" r: y& zroot # ceph quorum_status
: y3 v8 _# d* l0 [. `6 v6 w
0 F7 \* S1 C! b5 J- `Ceph 将返回仲裁状态。例如，由三个监视器组成的 Ceph 集群可能返回以下内容：
: n: p) q, ]7 Z6 D: f
% o6 {/ ^0 P' K{ "election_epoch": 10,

7 H& B9 g. t( Y0 ]% y6 x  "quorum": [
  S+ O5 U+ O! [8 f/ j" o* J; Q* q" e
        0,
* s2 `& R: b" T0 d# `: f* @
        1,
- I+ t4 V4 n6 _  `
, s* e+ p" [; Y  k4 [        2],

  "monmap": { "epoch": 1,

4 U' Y$ {' z9 u3 @" r9 y! T      "fsid": "444b489c-4f16-4b75-83f0-cb8097468898",
: C7 A- A  d% _# i
      "modified": "2011-12-12 13:28:27.505520",

5 D8 p5 e' d/ X7 {. }      "created": "2011-12-12 13:28:27.505520",

      "mons": [

            { "rank": 0,

              "name": "a",

              "addr": "127.0.0.1:6789\/0"},
; r1 m0 h! X- j* i: e0 Z! r" Q
% }/ {; Q1 D9 G$ n8 \8 A            { "rank": 1,
6 |! C! [$ D2 v% \8 D
. I1 _- z, R8 ]! y              "name": "b",

              "addr": "127.0.0.1:6790\/0"},

1 W) u8 |+ R1 _  Y            { "rank": 2,

              "name": "c",

  L7 Q$ O) _; U: u/ x0 ^$ g5 k+ f              "addr": "127.0.0.1:6791\/0"}

           ]
) P/ t/ R8 c) j
    }
. b: }+ Q% V0 N5 d, e1 O  M
}
( m" h" L+ v' ]% o. c; \# K8 z% p$ @
4.8 检查归置组状态

- f! J" G9 P8 n% e# I$ E8 M归置组会将对象映射到 OSD。监视归置组时，您希望它们处于 active 和 clean 状态。有关详细的讨论内容，请参见监视 OSD 和归置组。

4.9 使用管理套接字
& ^8 e' q& c. T9 N7 K
2 B9 r: }2 k" x3 d$ nCeph 管理套接字可让您通过套接字接口查询守护进程。默认情况下，Ceph 套接字驻留在 /var/run/ceph 下。要通过管理套接字访问守护进程，请登录运行守护进程的主机，并使用以下命令：
4 P9 t3 i9 M/ U% Q8 n  z
root # ceph --admin-daemon /var/run/ceph/socket-name
! r  B* |* N8 G7 f  ?
要查看可用的管理套接字命令，请执行以下命令：
0 E6 N* x4 ~$ o# u
root # ceph --admin-daemon /var/run/ceph/socket-name help

管理套接字命令可让您在运行时显示和设置您的配置。有关详细信息，请参见在运行时查看配置。
/ {% k: r9 Q8 y- t  h, i) t
& x$ A8 q0 a% @5 z另外，您也可以直接在运行时设置配置（管理套接字会绕过监视器，这与 ceph tell daemon-type.id injectargs 不同，后者依赖于监视器，但不需要您直接登录有问题的主机）。