[{"data":1,"prerenderedAt":1003},["ShallowReactive",2],{"navigation_docs":3,"-backend-development-observability":377,"-backend-development-observability-surround":998},[4,39,114,144,184,244,293,362],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":6},"Getting Started",false,"\u002Fgetting-started","1.getting-started",[10,15,20,25,30,35],{"title":11,"path":12,"stem":13,"icon":14},"Learning Path","\u002Fgetting-started\u002Flearning-path","1.getting-started\u002F1.learning-path","i-lucide-map",{"title":16,"path":17,"stem":18,"icon":19},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F2.introduction","i-lucide-house",{"title":21,"path":22,"stem":23,"icon":24},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F3.installation","i-lucide-download",{"title":26,"path":27,"stem":28,"icon":29},"Your First Program","\u002Fgetting-started\u002Ffirst-program","1.getting-started\u002F4.first-program","i-lucide-play",{"title":31,"path":32,"stem":33,"icon":34},"Modules and Dependencies","\u002Fgetting-started\u002Fmodules-and-dependencies","1.getting-started\u002F5.modules-and-dependencies","i-lucide-package-open",{"title":36,"path":37,"stem":38,"icon":34},"Advanced Modules","\u002Fgetting-started\u002Fadvanced-modules","1.getting-started\u002F6.advanced-modules",{"title":40,"path":41,"stem":42,"children":43,"page":6},"Fundamentals","\u002Ffundamentals","2.fundamentals",[44,49,54,59,64,69,74,79,84,89,94,99,104,109],{"title":45,"path":46,"stem":47,"icon":48},"Program Structure","\u002Ffundamentals\u002Fprogram-structure","2.fundamentals\u002F1.program-structure","i-lucide-workflow",{"title":50,"path":51,"stem":52,"icon":53},"Structs and Methods","\u002Ffundamentals\u002Fstructs-and-methods","2.fundamentals\u002F10.structs-and-methods","i-lucide-box",{"title":55,"path":56,"stem":57,"icon":58},"Interfaces","\u002Ffundamentals\u002Finterfaces","2.fundamentals\u002F11.interfaces","i-lucide-plug",{"title":60,"path":61,"stem":62,"icon":63},"Error Handling","\u002Ffundamentals\u002Ferrors","2.fundamentals\u002F12.errors","i-lucide-triangle-alert",{"title":65,"path":66,"stem":67,"icon":68},"Defined Types and Type Aliases","\u002Ffundamentals\u002Fdefined-types","2.fundamentals\u002F13.defined-types","i-lucide-tags",{"title":70,"path":71,"stem":72,"icon":73},"Generics","\u002Ffundamentals\u002Fgenerics","2.fundamentals\u002F14.generics","i-lucide-blocks",{"title":75,"path":76,"stem":77,"icon":78},"Project Structure","\u002Ffundamentals\u002Fproject-structure","2.fundamentals\u002F2.project-structure","i-lucide-folder-tree",{"title":80,"path":81,"stem":82,"icon":83},"Project Layout","\u002Ffundamentals\u002Fproject-layout","2.fundamentals\u002F3.project-layout","i-lucide-layout",{"title":85,"path":86,"stem":87,"icon":88},"Variables and Data Types","\u002Ffundamentals\u002Fvariables-and-types","2.fundamentals\u002F4.variables-and-types","i-lucide-variable",{"title":90,"path":91,"stem":92,"icon":93},"Functions","\u002Ffundamentals\u002Ffunctions","2.fundamentals\u002F5.functions","i-lucide-braces",{"title":95,"path":96,"stem":97,"icon":98},"Control Statements","\u002Ffundamentals\u002Fcontrol-statements","2.fundamentals\u002F6.control-statements","i-lucide-git-branch",{"title":100,"path":101,"stem":102,"icon":103},"Pointers","\u002Ffundamentals\u002Fpointers","2.fundamentals\u002F7.pointers","i-lucide-mouse-pointer-2",{"title":105,"path":106,"stem":107,"icon":108},"Arrays and Slices","\u002Ffundamentals\u002Farrays-and-slices","2.fundamentals\u002F8.arrays-and-slices","i-lucide-list",{"title":110,"path":111,"stem":112,"icon":113},"Maps","\u002Ffundamentals\u002Fmaps","2.fundamentals\u002F9.maps","i-lucide-table-properties",{"title":115,"path":116,"stem":117,"children":118,"page":6},"Concurrency","\u002Fconcurrency","3.concurrency",[119,124,129,134,139],{"title":120,"path":121,"stem":122,"icon":123},"Concurrency Model","\u002Fconcurrency\u002Fconcurrency-model","3.concurrency\u002F1.concurrency-model","i-lucide-network",{"title":125,"path":126,"stem":127,"icon":128},"Goroutines","\u002Fconcurrency\u002Fgoroutines","3.concurrency\u002F2.goroutines","i-lucide-git-fork",{"title":130,"path":131,"stem":132,"icon":133},"Channels","\u002Fconcurrency\u002Fchannels","3.concurrency\u002F3.channels","i-lucide-arrow-left-right",{"title":135,"path":136,"stem":137,"icon":138},"Select and Cancellation","\u002Fconcurrency\u002Fselect-and-cancellation","3.concurrency\u002F4.select-and-cancellation","i-lucide-circle-stop",{"title":140,"path":141,"stem":142,"icon":143},"Synchronization","\u002Fconcurrency\u002Fsynchronization","3.concurrency\u002F5.synchronization","i-lucide-lock-keyhole",{"title":145,"path":146,"stem":147,"children":148,"page":6},"Standard Library","\u002Fstandard-library","4.standard-library",[149,154,159,164,169,174,179],{"title":150,"path":151,"stem":152,"icon":153},"Standard Library Overview","\u002Fstandard-library\u002Foverview","4.standard-library\u002F1.overview","i-lucide-library",{"title":155,"path":156,"stem":157,"icon":158},"Text and Formatting","\u002Fstandard-library\u002Ftext-and-formatting","4.standard-library\u002F2.text-and-formatting","i-lucide-text",{"title":160,"path":161,"stem":162,"icon":163},"Files and JSON","\u002Fstandard-library\u002Ffiles-and-json","4.standard-library\u002F3.files-and-json","i-lucide-file-json",{"title":165,"path":166,"stem":167,"icon":168},"HTTP Clients and Servers","\u002Fstandard-library\u002Fhttp","4.standard-library\u002F4.http","i-lucide-server",{"title":170,"path":171,"stem":172,"icon":173},"Testing","\u002Fstandard-library\u002Ftesting","4.standard-library\u002F5.testing","i-lucide-flask-conical",{"title":175,"path":176,"stem":177,"icon":178},"Command-Line Tools and Configuration","\u002Fstandard-library\u002Fcommand-line-and-configuration","4.standard-library\u002F6.command-line-and-configuration","i-lucide-terminal-square",{"title":180,"path":181,"stem":182,"icon":183},"Structured Logging","\u002Fstandard-library\u002Fstructured-logging","4.standard-library\u002F7.structured-logging","i-lucide-scroll-text",{"title":185,"path":186,"stem":187,"children":188,"page":6},"Backend Development","\u002Fbackend-development","5.backend-development",[189,194,199,204,209,214,219,224,229,234,239],{"title":190,"path":191,"stem":192,"icon":193},"Backend Roadmap","\u002Fbackend-development\u002Fbackend-roadmap","5.backend-development\u002F1.backend-roadmap","i-lucide-route",{"title":195,"path":196,"stem":197,"icon":198},"Graceful Shutdown","\u002Fbackend-development\u002Fgraceful-shutdown","5.backend-development\u002F10.graceful-shutdown","i-lucide-power",{"title":200,"path":201,"stem":202,"icon":203},"Production Checklist","\u002Fbackend-development\u002Fproduction-checklist","5.backend-development\u002F11.production-checklist","i-lucide-clipboard-check",{"title":205,"path":206,"stem":207,"icon":208},"HTTP API Design","\u002Fbackend-development\u002Fhttp-api-design","5.backend-development\u002F2.http-api-design","i-lucide-waypoints",{"title":210,"path":211,"stem":212,"icon":213},"Middleware","\u002Fbackend-development\u002Fmiddleware","5.backend-development\u002F3.middleware","i-lucide-layers-3",{"title":215,"path":216,"stem":217,"icon":218},"Validation","\u002Fbackend-development\u002Fvalidation","5.backend-development\u002F4.validation","i-lucide-list-checks",{"title":220,"path":221,"stem":222,"icon":223},"Application Wiring","\u002Fbackend-development\u002Fapplication-wiring","5.backend-development\u002F5.application-wiring","i-lucide-cable",{"title":225,"path":226,"stem":227,"icon":228},"Observability","\u002Fbackend-development\u002Fobservability","5.backend-development\u002F6.observability","i-lucide-activity",{"title":230,"path":231,"stem":232,"icon":233},"Database SQL","\u002Fbackend-development\u002Fdatabase-sql","5.backend-development\u002F7.database-sql","i-lucide-database",{"title":235,"path":236,"stem":237,"icon":238},"Transactions","\u002Fbackend-development\u002Ftransactions","5.backend-development\u002F8.transactions","i-lucide-repeat-2",{"title":240,"path":241,"stem":242,"icon":243},"Authentication and Authorization","\u002Fbackend-development\u002Fauthentication","5.backend-development\u002F9.authentication","i-lucide-shield-check",{"title":245,"path":246,"stem":247,"children":248,"page":6},"Advanced Go","\u002Fadvanced-go","6.advanced-go",[249,254,259,264,269,274,278,283,288],{"title":250,"path":251,"stem":252,"icon":253},"Advanced Go Roadmap","\u002Fadvanced-go\u002Fadvanced-roadmap","6.advanced-go\u002F1.advanced-roadmap","i-lucide-brain-circuit",{"title":255,"path":256,"stem":257,"icon":258},"Reflection","\u002Fadvanced-go\u002Freflection","6.advanced-go\u002F2.reflection","i-lucide-scan-search",{"title":260,"path":261,"stem":262,"icon":263},"Memory and Garbage Collection","\u002Fadvanced-go\u002Fmemory-and-garbage-collection","6.advanced-go\u002F3.memory-and-garbage-collection","i-lucide-memory-stick",{"title":265,"path":266,"stem":267,"icon":268},"Benchmarking and Profiling","\u002Fadvanced-go\u002Fbenchmarking-and-profiling","6.advanced-go\u002F4.benchmarking-and-profiling","i-lucide-gauge",{"title":270,"path":271,"stem":272,"icon":273},"Advanced Testing and Fuzzing","\u002Fadvanced-go\u002Fadvanced-testing-and-fuzzing","6.advanced-go\u002F5.advanced-testing-and-fuzzing","i-lucide-microscope",{"title":275,"path":276,"stem":277,"icon":48},"Advanced Concurrency","\u002Fadvanced-go\u002Fadvanced-concurrency","6.advanced-go\u002F6.advanced-concurrency",{"title":279,"path":280,"stem":281,"icon":282},"Unsafe and C Boundaries","\u002Fadvanced-go\u002Funsafe-and-cgo","6.advanced-go\u002F7.unsafe-and-cgo","i-lucide-radiation",{"title":284,"path":285,"stem":286,"icon":287},"Package and API Design","\u002Fadvanced-go\u002Fpackage-and-api-design","6.advanced-go\u002F8.package-and-api-design","i-lucide-boxes",{"title":289,"path":290,"stem":291,"icon":292},"Distributed Reliability","\u002Fadvanced-go\u002Fdistributed-reliability","6.advanced-go\u002F9.distributed-reliability","i-lucide-cloud-cog",{"title":294,"path":295,"stem":296,"children":297,"page":6},"Projects","\u002Fprojects","7.projects",[298,316,332,347],{"title":299,"path":300,"stem":301,"children":302,"icon":305},"CLI Task Manager","\u002Fprojects\u002Fcli-task-manager","7.projects\u002F1.cli-task-manager\u002Findex",[303,306,311],{"title":304,"path":300,"stem":301,"icon":305},"Project — CLI Task Manager","i-lucide-list-todo",{"title":307,"path":308,"stem":309,"icon":310},"CLI — Domain and Storage","\u002Fprojects\u002Fcli-task-manager\u002Fdomain-and-storage","7.projects\u002F1.cli-task-manager\u002F1.domain-and-storage","i-lucide-save",{"title":312,"path":313,"stem":314,"icon":315},"CLI — Commands and Tests","\u002Fprojects\u002Fcli-task-manager\u002Fcommands-and-tests","7.projects\u002F1.cli-task-manager\u002F2.commands-and-tests","i-lucide-terminal",{"title":317,"path":318,"stem":319,"children":320,"icon":323},"Concurrent URL Checker","\u002Fprojects\u002Fconcurrent-url-checker","7.projects\u002F2.concurrent-url-checker\u002Findex",[321,324,328],{"title":322,"path":318,"stem":319,"icon":323},"Project — Concurrent URL Checker","i-lucide-radar",{"title":325,"path":326,"stem":327,"icon":128},"URL Checker — Worker Pipeline","\u002Fprojects\u002Fconcurrent-url-checker\u002Fworker-pipeline","7.projects\u002F2.concurrent-url-checker\u002F1.worker-pipeline",{"title":329,"path":330,"stem":331,"icon":173},"URL Checker — Cancellation and Tests","\u002Fprojects\u002Fconcurrent-url-checker\u002Fcancellation-and-tests","7.projects\u002F2.concurrent-url-checker\u002F2.cancellation-and-tests",{"title":333,"path":334,"stem":335,"children":336},"File-backed API","\u002Fprojects\u002Ffile-backed-api","7.projects\u002F3.file-backed-api\u002Findex",[337,339,343],{"title":338,"path":334,"stem":335},"File-backed notes API",{"title":340,"path":341,"stem":342},"File store and concurrency","\u002Fprojects\u002Ffile-backed-api\u002Ffile-store-and-concurrency","7.projects\u002F3.file-backed-api\u002F1.file-store-and-concurrency",{"title":344,"path":345,"stem":346},"HTTP layer and tests","\u002Fprojects\u002Ffile-backed-api\u002Fhttp-and-tests","7.projects\u002F3.file-backed-api\u002F2.http-and-tests",{"title":348,"path":349,"stem":350,"children":351},"Production REST API","\u002Fprojects\u002Fproduction-rest-api","7.projects\u002F4.production-rest-api\u002Findex",[352,354,358],{"title":353,"path":349,"stem":350},"Production REST API capstone",{"title":355,"path":356,"stem":357},"Persistence and authentication","\u002Fprojects\u002Fproduction-rest-api\u002Fpersistence-and-auth","7.projects\u002F4.production-rest-api\u002F1.persistence-and-auth",{"title":359,"path":360,"stem":361},"Operations and release","\u002Fprojects\u002Fproduction-rest-api\u002Foperations-and-release","7.projects\u002F4.production-rest-api\u002F2.operations-and-release",{"title":363,"path":364,"stem":365,"children":366,"page":6},"Meta","\u002Fmeta","99.meta",[367,372],{"title":368,"path":369,"stem":370,"icon":371},"About","\u002Fmeta\u002Fabout","99.meta\u002F1.about","i-lucide-info",{"title":373,"path":374,"stem":375,"icon":376},"Acknowledgements","\u002Fmeta\u002Facknowledgements","99.meta\u002F2.acknowledgements","i-lucide-heart-handshake",{"id":378,"title":225,"body":379,"description":990,"extension":991,"links":992,"meta":993,"navigation":994,"path":226,"seo":995,"stem":227,"__hash__":997},"docs\u002F5.backend-development\u002F6.observability.md",{"type":380,"value":381,"toc":977},"minimark",[382,388,393,397,416,420,423,475,478,482,485,506,509,513,516,519,538,541,558,561,565,568,571,691,698,702,705,822,829,832,836,847,851,854,858,861,864,868,906,910,917,936,940,957,967,970,973],[383,384],"learning-lesson-meta",{"level":385,"prerequisites":386,"time":387},"Intermediate","Structured logging, middleware, context, and HTTP servers","45–60 minutes",[389,390,392],"h2",{"id":391},"what-you-will-learn","What you will learn",[394,395,396],"p",{},"By the end of this lesson, you will be able to:",[398,399,400,404,407,410,413],"ul",{},[401,402,403],"li",{},"choose the right signal among logs, metrics, traces, and profiles;",[401,405,406],{},"define useful request and dependency measurements;",[401,408,409],{},"avoid dangerous high-cardinality metric labels;",[401,411,412],{},"propagate correlation context across boundaries;",[401,414,415],{},"expose diagnostics without exposing them publicly.",[389,417,419],{"id":418},"mental-model-ask-questions-of-a-running-system","Mental model: ask questions of a running system",[394,421,422],{},"Observability is the ability to understand internal behaviour from emitted signals. Each signal answers different questions.",[424,425,426,439],"table",{},[427,428,429],"thead",{},[430,431,432,436],"tr",{},[433,434,435],"th",{},"Signal",[433,437,438],{},"Best for",[440,441,442,451,459,467],"tbody",{},[430,443,444,448],{},[445,446,447],"td",{},"Logs",[445,449,450],{},"Detailed events and failure context",[430,452,453,456],{},[445,454,455],{},"Metrics",[445,457,458],{},"Trends, rates, saturation, alerts, and service objectives",[430,460,461,464],{},[445,462,463],{},"Traces",[445,465,466],{},"The path and timing of one request across components",[430,468,469,472],{},[445,470,471],{},"Profiles",[445,473,474],{},"Where CPU time, allocations, blocking, or contention occur",[394,476,477],{},"Do not force every detail into logs or every identifier into metrics.",[389,479,481],{"id":480},"start-with-request-metrics","Start with request metrics",[394,483,484],{},"For HTTP services, the RED model is a useful start:",[398,486,487,494,500],{},[401,488,489,493],{},[490,491,492],"strong",{},"Rate:"," requests per unit of time;",[401,495,496,499],{},[490,497,498],{},"Errors:"," failed requests per unit of time;",[401,501,502,505],{},[490,503,504],{},"Duration:"," request latency distribution.",[394,507,508],{},"Also observe dependency latency\u002Ferrors and resource saturation such as connection-pool wait, queue depth, memory, CPU, and goroutine counts when they reflect actionable limits.",[389,510,512],{"id":511},"control-metric-cardinality","Control metric cardinality",[394,514,515],{},"Metric systems create a time series for every unique label combination. Unbounded values can create an expensive explosion.",[394,517,518],{},"Safe labels are usually from bounded sets:",[398,520,521,524,527,535],{},[401,522,523],{},"route pattern, not raw URL path;",[401,525,526],{},"HTTP method;",[401,528,529,530,534],{},"status class such as ",[531,532,533],"code",{},"2xx"," or carefully bounded status code;",[401,536,537],{},"stable service or dependency name.",[394,539,540],{},"Unsafe labels commonly include:",[398,542,543,546,549,552,555],{},[401,544,545],{},"user ID;",[401,547,548],{},"request ID;",[401,550,551],{},"email address;",[401,553,554],{},"raw URL containing resource IDs;",[401,556,557],{},"arbitrary error messages.",[394,559,560],{},"Put high-cardinality identifiers in logs or traces where appropriate and protected.",[389,562,564],{"id":563},"correlate-signals","Correlate signals",[394,566,567],{},"A request ID links logs from one service. A trace ID links spans across services. Propagate supported tracing headers using a trusted instrumentation library rather than inventing a wire format.",[394,569,570],{},"Context carries request-scoped propagation information through function calls:",[572,573,578],"pre",{"className":574,"code":575,"language":576,"meta":577,"style":577},"language-go shiki shiki-themes solarized-light material-theme one-dark-pro","func (s *Service) Create(ctx context.Context, command CreateCommand) (Lesson, error) {\n    return s.repository.Create(ctx, command)\n}\n","go","",[531,579,580,653,685],{"__ignoreMap":577},[581,582,585,589,593,597,600,604,607,611,614,617,620,623,626,629,632,635,637,639,642,644,648,650],"span",{"class":583,"line":584},"line",1,[581,586,588],{"class":587},"sEOdo","func",[581,590,592],{"class":591},"shFME"," (",[581,594,596],{"class":595},"syre3","s ",[581,598,599],{"class":587},"*",[581,601,603],{"class":602},"snwKR","Service",[581,605,606],{"class":591},")",[581,608,610],{"class":609},"sisdC"," Create",[581,612,613],{"class":591},"(",[581,615,616],{"class":595},"ctx",[581,618,619],{"class":602}," context",[581,621,622],{"class":591},".",[581,624,625],{"class":602},"Context",[581,627,628],{"class":591},",",[581,630,631],{"class":595}," command",[581,633,634],{"class":602}," CreateCommand",[581,636,606],{"class":591},[581,638,592],{"class":591},[581,640,641],{"class":602},"Lesson",[581,643,628],{"class":591},[581,645,647],{"class":646},"sF6sA"," error",[581,649,606],{"class":591},[581,651,652],{"class":591}," {\n",[581,654,656,660,664,666,669,671,674,676,678,680,682],{"class":583,"line":655},2,[581,657,659],{"class":658},"s7Bcg","    return",[581,661,663],{"class":662},"s45-6"," s",[581,665,622],{"class":591},[581,667,668],{"class":662},"repository",[581,670,622],{"class":591},[581,672,673],{"class":609},"Create",[581,675,613],{"class":591},[581,677,616],{"class":662},[581,679,628],{"class":591},[581,681,631],{"class":662},[581,683,684],{"class":591},")\n",[581,686,688],{"class":583,"line":687},3,[581,689,690],{"class":591},"}\n",[394,692,693,694,697],{},"Do not replace the request context with ",[531,695,696],{},"context.Background()"," inside the call chain; doing so discards cancellation, deadlines, and trace relationships.",[389,699,701],{"id":700},"measure-at-boundaries","Measure at boundaries",[394,703,704],{},"Useful instrumentation sits around operations:",[572,706,708],{"className":574,"code":707,"language":576,"meta":577,"style":577},"started := time.Now()\nlesson, err := repository.Find(ctx, id)\nduration := time.Since(started)\n\nmetrics.ObserveRepositoryCall(\"lesson_find\", duration, err)\n",[531,709,710,730,761,781,788],{"__ignoreMap":577},[581,711,712,715,719,722,724,727],{"class":583,"line":584},[581,713,714],{"class":662},"started",[581,716,718],{"class":717},"su2KV"," :=",[581,720,721],{"class":662}," time",[581,723,622],{"class":591},[581,725,726],{"class":609},"Now",[581,728,729],{"class":591},"()\n",[581,731,732,735,737,740,742,745,747,750,752,754,756,759],{"class":583,"line":655},[581,733,734],{"class":662},"lesson",[581,736,628],{"class":591},[581,738,739],{"class":662}," err",[581,741,718],{"class":717},[581,743,744],{"class":662}," repository",[581,746,622],{"class":591},[581,748,749],{"class":609},"Find",[581,751,613],{"class":591},[581,753,616],{"class":662},[581,755,628],{"class":591},[581,757,758],{"class":662}," id",[581,760,684],{"class":591},[581,762,763,766,768,770,772,775,777,779],{"class":583,"line":687},[581,764,765],{"class":662},"duration",[581,767,718],{"class":717},[581,769,721],{"class":662},[581,771,622],{"class":591},[581,773,774],{"class":609},"Since",[581,776,613],{"class":591},[581,778,714],{"class":662},[581,780,684],{"class":591},[581,782,784],{"class":583,"line":783},4,[581,785,787],{"emptyLinePlaceholder":786},true,"\n",[581,789,791,794,796,799,801,805,809,811,813,816,818,820],{"class":583,"line":790},5,[581,792,793],{"class":662},"metrics",[581,795,622],{"class":591},[581,797,798],{"class":609},"ObserveRepositoryCall",[581,800,613],{"class":591},[581,802,804],{"class":803},"sED5a","\"",[581,806,808],{"class":807},"sVazx","lesson_find",[581,810,804],{"class":803},[581,812,628],{"class":591},[581,814,815],{"class":662}," duration",[581,817,628],{"class":591},[581,819,739],{"class":662},[581,821,684],{"class":591},[394,823,824,825,828],{},"The metric API should map errors to a bounded classification rather than using ",[531,826,827],{},"err.Error()"," as a label.",[394,830,831],{},"Avoid instrumentation that changes the behaviour being measured through blocking network calls on the request path. Exporters generally buffer or batch according to documented limits.",[389,833,835],{"id":834},"profiles-and-diagnostics","Profiles and diagnostics",[394,837,838,839,842,843,846],{},"The Go runtime can expose profiles understood by ",[531,840,841],{},"go tool pprof",", including CPU and heap data. The ",[531,844,845],{},"net\u002Fhttp\u002Fpprof"," package can register diagnostic HTTP handlers.",[848,849,850],"caution",{},"Do not expose profiling endpoints to the public internet. Profiles and runtime diagnostics can reveal sensitive implementation and workload details, and profiling can add overhead. Put them on a protected administrative listener or collect profiles through an authenticated operational channel.",[394,852,853],{},"Measure before optimising. Start with a representative workload, capture evidence, change one relevant factor, and compare results.",[389,855,857],{"id":856},"service-level-thinking","Service-level thinking",[394,859,860],{},"An alert should connect to user impact and an action. “CPU is 80%” is not automatically a failure. “The proportion of successful requests under the latency target is falling” describes service behaviour more directly.",[394,862,863],{},"Define objectives based on what users need, then choose metrics that measure those outcomes.",[389,865,867],{"id":866},"common-mistakes","Common mistakes",[398,869,870,876,882,888,894,900],{},[401,871,872,875],{},[490,873,874],{},"Using raw paths as labels:"," every resource ID can create a new time series.",[401,877,878,881],{},[490,879,880],{},"Recording every event at error level:"," alerts become noise and real failures disappear.",[401,883,884,887],{},[490,885,886],{},"Starting a new trace without preserving incoming context:"," distributed requests fragment.",[401,889,890,893],{},[490,891,892],{},"Adding instrumentation after incidents only:"," missing baseline signals make diagnosis slow.",[401,895,896,899],{},[490,897,898],{},"Making diagnostic endpoints public:"," internal state becomes externally accessible.",[401,901,902,905],{},[490,903,904],{},"Optimising from one profile captured under an unrealistic workload:"," the result may not matter in production.",[389,907,909],{"id":908},"practice","Practice",[394,911,912,913,916],{},"Design observability for ",[531,914,915],{},"POST \u002Flessons",". Specify one log event, request metrics, a trace span hierarchy, and a profiling strategy. Classify every attribute as bounded or unbounded.",[918,919,920],"accordion",{},[921,922,925,933],"accordion-item",{"icon":923,"label":924},"i-lucide-lightbulb","Show one possible design",[572,926,931],{"className":927,"code":929,"language":930,"meta":577},[928],"language-text","Log event: lesson create completed\n  request_id       unbounded → log only\n  lesson_id        unbounded → log only when policy permits\n  status           bounded\n  duration         numeric value\n\nMetrics:\n  http_requests_total{method=\"POST\", route=\"\u002Flessons\", status_class=\"2xx\"}\n  http_request_duration_seconds{method=\"POST\", route=\"\u002Flessons\"}\n  repository_calls_total{operation=\"lesson_create\", outcome=\"success\"}\n  repository_duration_seconds{operation=\"lesson_create\"}\n\nTrace:\n  server span POST \u002Flessons\n    child span lesson.Service.Create\n      child span database INSERT lesson\n\nProfiles:\n  protected administrative endpoint or controlled on-demand capture\n","text",[531,932,929],{"__ignoreMap":577},[394,934,935],{},"The exact metric and trace APIs depend on the chosen observability library. The design keeps label sets bounded and propagates the request context into service and repository calls.",[389,937,939],{"id":938},"summary","Summary",[398,941,942,945,948,951,954],{},[401,943,944],{},"Logs, metrics, traces, and profiles answer different questions.",[401,946,947],{},"Begin with request rate, errors, duration, and dependency saturation.",[401,949,950],{},"Keep metric labels bounded; never label metrics with user or request IDs.",[401,952,953],{},"Propagate context through every request-scoped boundary.",[401,955,956],{},"Protect runtime diagnostics and optimise only from representative evidence.",[394,958,959,960,622],{},"Official reference: ",[961,962,966],"a",{"href":963,"rel":964},"https:\u002F\u002Fgo.dev\u002Fdoc\u002Fdiagnostics",[965],"nofollow","Go diagnostics",[968,969],"learning-lesson-complete",{},[971,972],"learning-lesson-navigation",{"next":231,"next-label":230,"previous":221,"previous-label":220},[974,975,976],"style",{},"html pre.shiki code .sEOdo, html code.shiki .sEOdo{--shiki-light:#859900;--shiki-default:#89DDFF;--shiki-dark:#C678DD}html pre.shiki code .shFME, html code.shiki .shFME{--shiki-light:#657B83;--shiki-default:#89DDFF;--shiki-dark:#ABB2BF}html pre.shiki code .syre3, html code.shiki .syre3{--shiki-light:#657B83;--shiki-light-font-style:inherit;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#E06C75;--shiki-dark-font-style:italic}html pre.shiki code .snwKR, html code.shiki .snwKR{--shiki-light:#CB4B16;--shiki-default:#FFCB6B;--shiki-dark:#E5C07B}html pre.shiki code .sisdC, html code.shiki .sisdC{--shiki-light:#268BD2;--shiki-default:#82AAFF;--shiki-dark:#61AFEF}html pre.shiki code .sF6sA, html code.shiki .sF6sA{--shiki-light:#586E75;--shiki-light-font-weight:bold;--shiki-default:#C792EA;--shiki-default-font-weight:inherit;--shiki-dark:#C678DD;--shiki-dark-font-weight:inherit}html pre.shiki code .s7Bcg, html code.shiki .s7Bcg{--shiki-light:#859900;--shiki-light-font-style:inherit;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#C678DD;--shiki-dark-font-style:inherit}html pre.shiki code .s45-6, html code.shiki .s45-6{--shiki-light:#268BD2;--shiki-default:#EEFFFF;--shiki-dark:#E06C75}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .su2KV, html code.shiki .su2KV{--shiki-light:#859900;--shiki-default:#89DDFF;--shiki-dark:#E5C07B}html pre.shiki code .sED5a, html code.shiki .sED5a{--shiki-light:#2AA198;--shiki-default:#89DDFF;--shiki-dark:#98C379}html pre.shiki code .sVazx, html code.shiki .sVazx{--shiki-light:#2AA198;--shiki-default:#C3E88D;--shiki-dark:#98C379}",{"title":577,"searchDepth":655,"depth":655,"links":978},[979,980,981,982,983,984,985,986,987,988,989],{"id":391,"depth":655,"text":392},{"id":418,"depth":655,"text":419},{"id":480,"depth":655,"text":481},{"id":511,"depth":655,"text":512},{"id":563,"depth":655,"text":564},{"id":700,"depth":655,"text":701},{"id":834,"depth":655,"text":835},{"id":856,"depth":655,"text":857},{"id":866,"depth":655,"text":867},{"id":908,"depth":655,"text":909},{"id":938,"depth":655,"text":939},"Use logs, metrics, traces, and profiles to understand a running service without guessing.","md",null,{},{"icon":228},{"description":996,"title":225},"Learn backend observability concepts in Go including structured logs, RED metrics, traces, cardinality, health, and protected profiles.","iVggovBbDRXAJAxQHkYHlM5mC12z2suDZ-dRAbjSaS8",[999,1001],{"title":220,"path":221,"stem":222,"description":1000,"icon":223,"children":-1},"Build a small composition root that loads configuration, creates dependencies, and controls startup.",{"title":230,"path":231,"stem":232,"description":1002,"icon":233,"children":-1},"Use database\u002Fsql safely with connection pools, contexts, parameters, row cleanup, and explicit mappings.",1794118102250]