# OpenTelemetry 入門指南：
建立全面可觀測性架構

# **OpenTelemetry 入門指南：建立全面可觀測性架構（iThome鐵人賽系列書）**

---

## [博碩連結](https://www.drmaster.com.tw/bookinfo.asp?BookID=MP22334)

## [天瓏書局連結](https://www.tenlong.com.tw/products/9786263338739?list_name=p-r-zh_tw)

## [作者鐵人賽系列](https://ithelp.ithome.com.tw/users/20104930/profile)

> 印刷書因圖片太大以及對比問題，能前往各章節圖片資料夾中觀看原圖。
> 
> [圖片連結](https://github.com/tedmax100/OpenTelemetryEntryBeook/tree/main/%E5%90%84%E7%AB%A0%E7%AF%80%E5%9C%96%E7%89%87)
> 
> 或前往該文章底部

---

## 作者簡介

* **雷N**  
    作者擁有十年後端系統的設計與開發經驗，目前以 Go 為主要程式語言進行開發。在工作經驗上，作者經歷過單體服務的演化至微服務架構，以及從地端環境轉移到雲端的容器託管環境。透過這段深入的實務應用過程，作者深刻體會到現代複雜且動態系統架構下，主動強化系統的可觀測性能力對整個開發團隊的重要性。因此，此著作主要從後端工程師的角度出發，旨在幫助讀者全面理解和深入掌握 OpenTelemetry 的技術和應用。
    
    \> Blog︰[https://ganhua.wang/](https://ganhua.wang/)
    

## 本書特色

* **本書內容改編自第14屆iThome鐵人賽DevOps組佳作系列文章  
    《淺談DevOps與Observability》**
    
    **【本書特色】**  
    本書探討如何透過系統可觀測性應對日益複雜的系統架構，如微服務及雲端環境。隨著系統架構的演進，傳統的地端管理方式已不敷使用，作者提供一系列基於可觀測性工程的實踐方法來解決營運中遇到的問題，這些方法不僅適用於技術人員日常的維護工作，也便於團隊引入並落實。
    
    書中重點介紹了如何使用OpenTelemetry標準框架結合Grafana Labs提供的開源工具，如Grafana、Loki、Tempo及Prometheus來收集、組裝和呈現遙測數據。這些工具和框架的配合使用，能夠有效地增強系統的可觀測性，並以儀表板直觀展示系統行為數據，從而提供深入分析。
    
    此外，本書也介紹了k6這一系統負載測試工具，它能幫助團隊在開發週期中建立多種測試場景，即時顯示性能指標，進而在預備環境中驗證系統是否能達到預定的SLO。這不僅優化了開發流程，也為系統穩定性提供了保障。
    
    最後，作者結合自身在使用OpenTelemetry的實務經驗，並且作為「The Observability Engineering」一書的譯者，引導讀者理解OpenTelemetry的運用方式及其在系統監控中的獨特價值，展示了如何通過增強系統的可觀測性來滿足當前與未來的監控需求。
    
    **【專業推薦】**  
    從基礎理論說明到實踐，甚至是一步一步完成 Demo 的工作坊，這本書都一應俱全。雖然書名是《OpenTelemetry 入門指南》，但其內容的完整程度，對於初學 OpenTelemetry，或是想導入 OpenTelemetry 到手上系統的團隊，都能滿足需求。相信這本書一定是學習 OpenTelemetry 的最佳選擇！  
    **OAuth 2.0 從入門到實戰作者  
    Miles**
    
    在本書中，雷N 從 OpenTelemetry 的歷史背景到具體架構及其核心元件，再到可觀測性重要支柱，進行了詳細的闡述。隨後，他通過 OpenTelemetry Collector 的功能，將理論與實踐結合，展示了如何在實際項目中應用 OpenTelemetry。不僅如此，他還進一步整合了在可觀測性領域中備受推崇的 Grafana Stack，大大提升了 OpenTelemetry 和可觀測性的實用性。  
    **Grafana 傳教士  
    Mike Hsu**
    

---

## 本書目錄

* **第一部份 : 從傳統到轉型：探索現代 IT 架構**  
    **CH 1 : 現代化系統架構的演化**  
    1.1 單體應用的 Client/Server 架構  
    1.2 分層式元件化應用時代  
    1.3 SOA 服務導向架構  
    1.4 微服務架構
    
    **CH 2 : DevOps 簡介**  
    2.1 DevOps 的起源與定義  
    2.2 DevOps 的核心價值觀 CAMS  
    2.3 DevOps 研究與評估組織 DORA
    
    **CH 3 : 什麼是可觀測性 Observability**  
    3.1 可觀測性一詞的起源  
    3.2 可觀測性的概念與重要性  
    3.3 可觀測性與監控的區別  
    3.4 可觀測性的基本遙測資料
    
    **第二部份 : 可觀測性開源標準 OpenTelemetry**  
    **CH 4：淺談 OpenTelemetry**  
    4.1 OpenTelemetry 的前世今生  
    4.2 簡介 OpenTelemetry  
    4.3 OpenTelemetry 客戶端核心元件  
    4.4 OpenTelemetry 的功能狀態與版本管理  
    4.5 OpenTelemetry 的願景
    
    **CH 5：OpenTelemetry 信號**  
    5.1 Signal  
    5.2 Logs  
    5.3 Metrics  
    5.4 Trace  
    5.5 Baggage
    
    **CH6： Trace SDK 與 Metric SDK介紹**  
    6.1 Span 取樣器  
    6.2 Span 處理器  
    6.3 Span 匯出器  
    6.4 指標樣本
    
    **CH7：OpenTelemetry Collector**  
    7.1 OpenTelemetry Collector  
    7.2 Collector 流水線與組成  
    7.3 遙測資料接收器  
    7.4 遙測資料處理器  
    7.5 遙測資料匯出器  
    7.6 流水線連結器  
    7.7 Collector 擴展功能  
    7.8 綜合演示
    
    **CH 8：動手玩OpenTelemetry Demo專案**  
    8.1 環境建置  
    8.2 架構與設計  
    8.3 看見問題  
    8.4 Grafana Demo 儀表板說明
    
    **第三部分：Grafana 開源工具應用**  
    **CH 9：Grafana 基本概念與應用**  
    9.1 介紹 Grafana  
    9.2 初次使用 Grafana  
    9.3 整合 Grafana 資料來源  
    9.4 Grafana 儀表板  
    9.5 Grafana 主動配置
    
    **CH 10：Grafana Loki**  
    10.1 介紹 Grafana Loki  
    10.2 Loki LogQL  
    10.3 Loki 與 Collector 和 Grafana 的整合
    
    **CH11：Grafana Tempo**  
    11.1 介紹 Grafana Tempo  
    11.2 TraceQL  
    11.3 追蹤與日誌的整合  
    11.4 追蹤與指標的關聯
    
    **CH12：改造 OpenTelemetry Demo專案**  
    12.1 整合日誌與追蹤  
    12.2 整合指標與追蹤
    
    **第四部分：負載測試工具**  
    **CH13：Grafana k6‧系統測試神器**  
    13.1 Grafana k6 簡介  
    13.2 各種類型的系統測試  
    13.3 k6 與 Postman 和 OpenAPI 的整合  
    13.4 k6 與 Github Action 的整合  
    13.5 OpenTelemetry Demo 專案改造計畫 - 2
    
    **附錄 Collector 內建指標**
    

---

## 錯字修訂

1. 圖3-12 handnle -> handler
    
2. 圖4-3 Watefall -> Waterfall
    
3. 13-15 計量器(Gauge) -> 量規(Gauge)
    

---

## 書本原圖

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020201742/26266ce2-c493-4f97-9469-5bf56d2b24fe.png align="center")

圖3-4

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020215440/14d0a853-f261-43e7-8c4d-4c74664aa5ea.png align="center")

圖3-5

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020249471/3d086a35-9a5b-4d76-a66a-3339aac70be1.png align="center")

圖3-6, hadnler 修訂成 handler

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020287057/a99bd2e9-41ea-433c-a356-021665de96cf.png align="center")

圖5-10

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020295627/bc2c7fc9-e06f-455a-b21a-2bf72e411946.png align="center")

圖5-12

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020303015/fb892669-8a92-4c5e-8d70-7e823fa0825c.png align="center")

圖5-13

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020317348/adcdd0d1-6b78-4fd1-9388-1536343f34fb.png align="center")

圖5-15

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020323430/55b9a075-e7e5-4728-aa12-a70be508f18c.png align="center")

圖5-17

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020342166/548775ce-dca1-4a6a-ab78-deab931338db.png align="center")

圖7-13

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020355295/c205d02d-195d-451a-a845-131dd1a41f60.png align="center")

圖7-14

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020359868/9dd28f88-7f0a-4a30-9cec-fb5043f05b5e.png align="center")

圖7-15

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020363302/0b819299-1e70-47b9-9739-f2cd87f2fb93.png align="center")

圖7-16

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020372212/63216812-e216-4e25-84f9-ea81b6f6b5d3.png align="center")

圖7-17

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020377673/848f9f34-4714-4d03-b5ab-c7c1a1e075c6.png align="center")

圖7-18

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020385408/55dfb77f-d64b-4ea5-bfcd-eaf5d7b300b1.png align="center")

圖8-1

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020393511/270da84e-04ec-4e8f-af5d-028206568a09.png align="center")

圖8-2

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020399954/53e1f0cb-570a-4ced-bfea-5c1937779529.png align="center")

圖8-6

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020405439/72b92506-c424-44a6-b455-1a73cf86953f.png align="center")

圖8-7

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020415004/237a8397-ea73-4168-b01f-7006d186685a.png align="center")

圖8-11

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020442188/50cf6aff-3428-49c1-9454-b30f244b63ca.png align="center")

圖8-12

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020448282/5d35e7fb-96dc-46c8-b760-1b527912fed9.png align="center")

圖8-13

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020453229/ec45ccd3-9cff-4189-b651-2c147e545f5c.png align="center")

圖8-16

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020458523/6dbbe27e-f8d8-48e7-a6d4-cee67f00203a.png align="center")

圖8-17

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020467066/e5753def-e7d6-464f-a2fa-016861791588.png align="center")

圖8-18

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020472904/0bf59b80-8d83-4d84-b9d5-6a5d55b99832.png align="center")

圖8-19

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020478078/c76ded25-d48e-4a5c-b869-d1de78be83e5.png align="center")

圖8-20

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020484043/36a83c34-ee53-4e13-a832-a5e7169a8e7f.png align="center")

圖8-21

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020495804/45e29c63-6046-4001-8e8a-408f89664203.png align="center")

圖8-22

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020501512/c0e352f4-b026-4358-9d5d-277ead89f4f0.png align="center")

圖8-23

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020509508/d725cd09-d852-4de0-a101-5f2a0ff40fa0.png align="center")

圖9-3

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020517944/a6750f14-ebd0-40a1-8e70-24e6c90ee02a.png align="center")

圖9-4

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020524801/d73f6de1-3ac0-42a1-90fe-643186e9ccb3.png align="center")

圖9-5

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020528723/b8cb2f1e-17f2-4f89-9aab-5ee0535c368a.png align="center")

圖9-6

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020534509/5c83a071-ae87-43d2-8044-2f215be2e952.png align="center")

圖9-7

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020542813/aed250c7-85ae-42c9-8476-12a629ebc9e7.png align="center")

圖9-8

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020549025/db0bfc13-35ad-47a3-8c37-51fb59105710.png align="center")

圖9-9

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020555736/3a62b68a-9a7c-4b26-971f-29f5178ecfff.png align="center")

圖9-10

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020563246/db8a6e8d-7e98-4748-ba2a-2063ddb91cbf.png align="center")

圖9-11

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020571202/e303f993-6ba6-4c39-b4ca-1120c53e5b22.png align="center")

圖9-13

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020590503/c2b3273b-cf8f-465c-8893-7f78792e5ce4.png align="center")

圖9-15

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020598059/04580187-299b-4dc2-b1ef-60900ac0440b.png align="center")

圖9-16

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020604183/9c80fca0-3aa0-4098-b083-e450826c2f9f.png align="center")

圖9-17

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020610711/faa44348-2d9c-4885-945f-fe5145978fc9.png align="center")

圖10-7

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020620030/b7391f65-cefe-4f15-a5b0-f1eab8305d8c.png align="center")

圖10-8

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020624697/b2f9a86c-e07b-4e04-8d12-5af94a97a602.png align="center")

圖10-9

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020631750/473065ac-90e4-414b-8f2a-b584b86b39e1.png align="center")

圖10-10

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020636843/b8b0fe1a-36dc-4c8e-991e-1372a472c998.png align="center")

圖10-11

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020646546/fd503a27-a578-42ab-8e09-2329f796d42b.png align="center")

圖10-12

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020650898/d699ffed-300e-4054-a7e3-9c5ad4142be0.png align="center")

圖10-14

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020657390/7f0385b9-a6c4-48f1-b370-3c3e859cfe5d.png align="center")

圖10-15

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020717397/526a9164-2cdc-48fe-837f-50fa417df605.png align="center")

圖10-17

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020721699/5035dfca-d2ae-41b0-9969-17d59b3fd3c9.jpeg align="center")

圖11-3

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020733413/7ccd0a02-8dd2-44f3-ad23-580e9e0df8c2.png align="center")

圖11-4

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020738579/5e934599-460e-48f9-9e80-2ddb99faa492.png align="center")

圖11-5

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020743515/4ba0d52f-7e1f-45d1-847d-5e35decbfd2c.png align="center")

圖11-6

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020749785/1faafabd-a171-45bf-af59-6ed73b107c11.png align="center")

圖11-7

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020754776/7fe553e5-045d-4cf2-a7b1-0f7cf828a266.png align="center")

圖11-9

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020760550/12427d74-b6a2-4f52-b52e-b88e6f6e56fa.png align="center")

圖11-10

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020767713/17d0c572-e687-4106-a494-26456a4c3916.png align="center")

圖11-11

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020772731/ec1d10b7-f2af-4252-8fda-34e48228a55c.png align="center")

圖11-12

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020777526/c7f27ded-8a99-4aa8-9b13-c0a4dd57f397.png align="center")

圖11-14

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020782774/3ed652ef-0d86-4cee-b6b9-43f41b0e0efb.png align="center")

圖11-15

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020787493/efa7d94f-d9a7-4f7d-a8ad-57f704601cda.png align="center")

圖11-16

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020793383/df544e70-66c8-4476-99a0-235853f84293.png align="center")

圖11-17

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020798265/868edb9a-8bbd-44dd-bf1f-e1e05539de54.png align="center")

圖11-18

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020805943/bc0b5aab-083f-4f7d-89a1-a33e519fef04.png align="center")

圖11-19

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020811785/c156c60c-4c11-43df-a386-4f230bfd64cf.png align="center")

圖11-20

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020818530/cc672da5-9d01-4ab3-80bd-2e9ecbe7f166.png align="center")

圖12-1

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020826558/638cfda9-6df4-4fa7-9c76-fee5da352476.png align="center")

圖12-2

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020831787/50a29a93-c976-447b-bf85-05a9459dc91f.png align="center")

圖12-3

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020842774/ec2783eb-4a41-4a0f-9a81-4019f9e4d700.png align="center")

圖12-4

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020847014/d1e60c55-9a51-4726-8fef-5f908bc30836.png align="center")

圖12-5

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020853916/34049f99-012b-4daf-baa7-dcd455a77bdb.png align="center")

圖13-5

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020861713/9aeb212e-c347-48f7-8a03-3b2a26a08693.png align="center")

圖13-6

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020866536/73642d09-93f0-45a0-b86f-b0313dd757e7.png align="center")

圖13-7

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020873469/effaa587-907e-4b19-9033-dc01437e0382.png align="center")

圖13-8

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020878492/edd36f8e-6951-4c38-af77-97aedd5d1413.png align="center")

圖13-10

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020887550/6b27b529-6aff-411a-b40a-27fa98edb83d.png align="center")

圖13-14

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020893715/4a1f2f24-7cf3-4aa2-b877-31f3b19fb1a2.png align="center")

圖13-15

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020898837/faf4fd43-af59-4889-b81e-437171c75344.png align="center")

圖13-17

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020905273/c7cef5d5-818b-4222-88a0-e6635fc50684.png align="center")

圖13-18

![](https://cdn.hashnode.com/res/hashnode/image/upload/v1720020913171/997b774c-0e56-4888-b913-62be355b4b45.png align="center")

圖13-19