機器人可觀測性是指能夠從發出的證據重建內部軟體執行和外部物理行為的能力。顯示節點存活的螢幕無法解釋為何移動操作員選擇錯誤物件、使用陳舊變換並進入恢復狀態。
紀錄記錄事件，指標彙總測量，追蹤跨元件工作。機器人還需要感測器和致動器證據、時鐘同步質量、任務身份和設定沿革，因為物理事件涉及跨介面裝置、車隊服務和人工操作。
本指南應與 機器人延遲預算指南 及 資料集譜係指南一起使用。收集必須遵守網路安全、隱私、保留和安全約束。
圍繞問題和事件設計可觀測性
從決策開始：哪個任務失敗了，哪個命令到達致動器，感知輸入有多久，執行了哪個設定，以及延遲或狀態分歧從哪裡開始。每個問題定義證據、相關性和保留需求。
對從任務分配到規劃、推斷、控制、裝置反應和任務結果的關鍵路徑進行儀器化。避免在沒有調查用例和資源預算的情況下收集所有可能的欄位。
給紀錄、指標和追蹤分配不同的工作
結構化紀錄捕捉離散事件及其上下文。度量彙總值隨時間變化，用於警報和趨勢檢測。追蹤表示操作作為元件間的相關跨；這些單獨無法替代原始物理證據。
官方 的 OpenTelemetry 訊號檔案 將跟蹤、指標、紀錄和行李列為支援的類別。地圖機器人概念應謹慎而非假設雲服務語意規範自動適用於運動和硬體。
| 訊號 | 最好的問題 | 機器人示例 | 誤用則失效 |
|---|---|---|---|
| 紀錄 | 發生了什麼事件 | 安全停止理由 | 自由文字無法關聯 |
| 度規 | 多少或多頻繁 | P95 指揮年齡 | 原始 ID 的基數爆炸性 |
| 追蹤 | 時間去了哪裡 | 任務到執行跨度 | 缺失上下文會斷開鏈條 |
| 錄音 | 實際發生了什麼 | 影像、關節與命令 | 儲存與隱私過載 |
| 設定快照 | 具體是什麼 | 模型、地圖與校正 | 事件無法複製 |
跨邊界傳播一個操作身份
建立具有明確生命週期的車隊、機器人、任務、任務、嘗試和恢復辨識符號。在服務呼叫、佇列和裝置命令之間，攜帶跟蹤和跨越上下文，同時在重試工作時保持物理事件身份可見。
W3C Trace Context 建議 標準化了分散式上下文的 traceparent 和 tracestate。在相容介面使用其規則，並為現場匯流排、 ROS 訊息和離線錄製定義顯式對映。
把時鐘同步質量納入每一個延遲申報中
不同時鐘的時間戳在不確定偏移、漂移和不確定性的情況下不能安全減去。記錄時鐘源和同步狀態，並使用單調時間處理區域性時鐘修正可能跳躍的時段。
當同步下降時，保持事件順序和不確定性，避免釋出虛假的精確延遲。關聯感測器暴露、訊息到達、回呼開始、推論完成、命令應用和測量運動。
使用結構化紀錄和穩定模式
包括事件名稱、嚴重度、時間戳和時鐘、操作 ID、元件和版本、機器人狀態、原因程式碼以及有界診斷欄位。保留人類可讀的文字作為解釋，而非唯一機器可查詢的值。
OpenTelemetry 的 紀錄規範 支援透過 TraceId 和 SpanId 進行相關。保留原始裝置錯誤程式碼和對映版本，以確保正規化不會抹除證據。
控制度量標籤與基數
根據測量到的行為使用計數器、計量器和直方圖。指標可以總結故障率、佇列深度、命令年齡、推斷延遲、控制截止時間未達、電池狀態和介入持續時間。
目前 的 OpenTelemetry 指標指南 警告，唯一屬性組合會增加記憶體成本，並描述了 SDK 的基數限制。不要在每個度量系列上放置原始任務、使用者或物件辨識符號；將範例或有界標籤與詳細的跟蹤和紀錄連線起來。
追蹤非同步機器人工作與重試
任務可能擴充為感知、規劃、地圖、策略和裝置呼叫，然後透過佇列或離線邊緣鏈路繼續。巢狀工作使用父子跨，當因果工作不是單一同步呼叫樹時使用跨鏈路。
記錄入隊和脫排隊時間、重試次數、超時所有者和結果。 OpenTelemetry 的 跟蹤檔案 解釋了跨度、上下文傳播、事件和鏈路；應用保留失敗和代表成功操作的取樣規則。
在遙測資料旁保留物理證據
針對特定事件，獲取感測器影格、關節狀態、命令、變換、安全事件和操作員操作，並獲得同意和儲存控制。保留單元、協調影格、序列化以及資訊 QoS 或丟棄資訊。
ROS 2 rosbag2 檔案已針對 Rolling 發行版進行了版本管理；固定部署所用的發行版和儲存外掛版本。沒有時鐘、設定和事件 ID 的 bag 檔案仍然難以解釋。
快照軟體、模型、地圖和校正譜系
將構建 ID、容器或包摘要、模型和資料集譜系、地圖、工具、校正、控制器參數和特徵標誌附加到機器人資源或事件包上。不要依賴可變標籤的最新版本。
使用 機器人資料集譜系工作流程，將學習到的工件與其輸入連線起來。保留更新和回復事件，避免將混合車隊分析為一個設定。
構建一個支援反證的事件包
事故記錄應包含時間線、受影響設定、紀錄、度量視窗、痕跡、選定的物理記錄、操作員陳述、候選原因以及與每個假設相矛盾的證據。根本原因不應從第一個令人警戒的圖表中選擇。
將確認的反覆案例與 故障挖掘指南 連線起來，同時將培訓選擇與營運裁定和安全報告分開。
預算遙測、安全、隱私及執行退化
按訊號類別設定收集速率、本地緩衝、上傳優先順序、保留和編輯。攝影機、音訊、精確位置和工作人員辨識符號可以帶來隱私和安全暴露；保護存取並證明刪除行為。
可觀測性不應扼殺控制或安全任務。測試斷開操作、儲存耗盡、集電器故障和紀錄風暴。機器人應保持有界臨界環緩衝，並根據其執行安全設計繼續或停止。
釋出可觀測性驗收規範
保留事件問題、訊號模式、辨識符號壽命、上下文傳播、時鐘同步質量、取樣、基數預算、緩衝區和保留規則、存取控制、設定沿襲和重放測試。
仔細審查，請進行以下檢查。
評估“機器人可觀測性：紀錄、指標與分散式追蹤”時，還應儲存模型版本、機器人設定、校正檔案、測試日期和全部試驗記錄。
只有把這些持續投入與單位成功任務的價值比較，才能判斷方案是否適合擴大。
上線後仍要持續檢查分佈變化、感測器漂移、機械磨損和人工接管原因。
實際專案還應指定資料、模型、控制器和安全流程的負責人，並預先定義回復條件。責任邊界、審批記錄與變更紀錄越清楚，故障發生後越容易停止擴散、定位原因並安全恢復。
| 驗收測試 | 注射狀態 | 所需證據 | 失敗 |
|---|---|---|---|
| 相關性 | 跨軍種重試 | 一任務與嘗試鏈 | 重複或損壞的 ID。 |
| 時間安排 | 時鐘偏移與漂移 | 合格期限或不確定性 | 假延遲 |
| 取樣 | 罕見的臨界故障 | 保留跡束和物理叢 | 頭部取樣滴劑盒 |
| 資源 | 網路與磁碟壓力 | 有界控制影響 | 遙測干擾機器人 |
| 重賽 | 已知事件 | 時間線和設定可複製 | 僅儀表盤診斷 |
- 追蹤一個任務從派遣到實際結果。
- 記錄時鐘源、偏移和不確定性。
- 避免指標有界限且詳細的 ID 出現在標籤中。
- 將遙測資料與精確軟體和校正版本連線。
- 證明在網路丟失和儲存壓力下的事件捕獲。
常見問題
原木足夠讓機器人可觀測嗎？
不。紀錄需要指標、痕跡、物證、時鐘同步質量和設定上下文來重建許多事件。
機器人 ID 應該作為一個公制標籤嗎？
有界車隊標籤可能是合理的，但高基數辨識符號需要明確的成本分析，通常應放在跟蹤或紀錄中。
跟蹤時間戳能證明端對端延遲嗎？
只有當時鍾和傳播邊界被限定時；否則報告區域性時長和同步不確定性。
每一次成功的任務都應該被完整記錄嗎？
通常不會。使用基於風險的抽樣、總結和有界緩衝區，同時保留關鍵失敗和代表性成功。
可觀測效能取代安全監控嗎？
不。它支援診斷和證據；經過驗證的安全功能必須獨立於普通遙測資料的可用性。
事件-重建證據邊界
機器人可觀測性在團隊能夠重建物理事故、辨識準確設定並測試相互競爭的解釋而不影響控制、安全、隱私或車隊營運的情況下取得成功。