docs/observability: fix stale and wrong information

cmd/atelet/metrics.go

@@ -166,8 +166,9 @@ func restoreSnapshotKind(directLocal bool, rec *sandboxAssetsRecord) string {
 	return ateattr.SnapshotKindLatest
 }
 
-// checkpointSnapshotKind classifies which snapshot a checkpoint writes: a pause
-// writes the node-local one, and a suspend writes a durable latest snapshot.
+// checkpointSnapshotKind classifies which snapshot a checkpoint writes: an
+// asynchronous suspend writes the node-local one, and a synchronous suspend
+// writes a durable latest snapshot.
 func checkpointSnapshotKind(req *ateletpb.CheckpointRequest) string {
 	if req.GetUploadConfig().GetMode() == ateletpb.UploadMode_UPLOAD_MODE_DEFERRED {
 		return ateattr.SnapshotKindLocal

docs/metrics/registry/metrics.yaml

@@ -104,14 +104,14 @@ groups:
               stability: development
               value: suspending
               brief: >
-                ateapi is writing a snapshot: durable for a suspend,
-                node-local for a pause.
+                ateapi is writing a snapshot: node-local for an asynchronous
+                suspend, durable for a synchronous suspend.
             - id: suspended
               stability: development
               value: suspended
               brief: >
-                The actor holds no worker. Its latest snapshot is durable, or
-                node-local after a pause.
+                The actor holds no worker. Its latest snapshot is durable,
+                node-local, or both.
             - id: crashed
               stability: development
               value: crashed
@@ -298,7 +298,10 @@ groups:
             - id: local
               stability: development
               value: local
-              brief: A snapshot on the node. A pause writes it.
+              brief: >
+                The copy on the node. An asynchronous suspend writes it. A
+                resume reads it while the node still has it, after either kind
+                of suspend and whether or not the upload has finished.
             - id: latest
               stability: development
               value: latest