🖼️ See the drawing + lab 🏠 Course home 🌿 Branch on GitHub ✏️ View source

🖼️ आकृती आणि labThe drawing + lab पूर्ण पानावर उघडा ↗Open full page ↗

🔧 धडा 12 — network चे debugging: तपासणीची शिडी

📍 तुम्ही इथे आहात: 12 पैकी धडा 12 · 🎓 शेवटचा

📦 या ब्रँचमध्ये काय आहे

धडे 01–12 — संपूर्ण कोर्स. "बंद पडले" चे रूपांतर नाव असलेल्या कारणात करणारी शिडी, आणि प्रत्येक पायरीवरची साधनपेटी.

net/lab.sh — एकाच script मधली शिडी: dig → ping → traceroute → nc → openssl → curl → कोण ऐकत आहे
net/demo.py — प्रत्येक विभाग म्हणजे Python मधली एक पायरी

🧒 5 वर्षांच्या मुलाला समजावल्यासारखे

पत्र पोहोचत नाही तेव्हा तुम्ही इमारतीवर ओरडत नाही. तुम्ही एक शिडी चढता: नाव निर्देशिकेत आहे का? मला इमारतीपर्यंत पोहोचता तरी येते का? कोणता corridor चुकतो? खोली उघडी आहे का? सील वैध आहे का? पत्र स्वतः नीट लिहिलेले आहे का? त्यानंतरच: कारकुनाने log मध्ये काय लिहिले? प्रत्येक पायरीला एक tool असते, आणि जी पहिली पायरी fail होते तीच कारण सांगते.

🗺️ आकृती

flowchart LR
  A["1 DNS<br/>dig +short"] --> B["2 reach<br/>ping"] --> C["3 route<br/>traceroute"] --> D["4 port<br/>nc -zv"] --> E["5 TLS<br/>openssl s_client"] --> F["6 HTTP<br/>curl -v"] --> G["7 logs<br/>the app"]

❓ काय

पायरी	प्रश्न	Tool	कारण सांगणारी error
1	DNS आहे का?	`dig +short`, `nslookup`	NXDOMAIN, जुना पत्ता
2	मला पोहोचता येते का?	`ping`, `mtr`	100% loss (किंवा ping अडवलेला — तरीही पायरी 4 तपासा)
3	कोणता corridor?	`traceroute`, `tracepath`	hops एका router वर थांबतात
4	खोली उघडी आहे का?	`nc -zv`, `ss -ltnp`	refused (रिकामी) विरुद्ध timed out (फाटक)
5	सील वैध आहे का?	`openssl s_client`, `curl -v`	expired, चुकीचे नाव, अनोळखी CA
6	पत्र बरोबर आहे का?	`curl -v`, `tcpdump`	4xx तुमची चिठ्ठी, 5xx त्यांचे कार्यालय, अडकणे = length नाही
7	आत काय घडले?	app चे logs, request id	बाकी सगळे

Latency विरुद्ध bandwidth: ping latency मोजतो (ms, अंतर, hops); download bandwidth मोजतो (Mbit/s). दूरची हळू site म्हणजे latency; हळू मोठी file म्हणजे bandwidth.
tcpdump / Wireshark: दुसरे काहीच स्पष्ट करत नसेल तेव्हा लखोटे स्वतःच वाचा.

🤔 का

क्रम महत्त्वाचा आहे: DNS ची चूक पुढची प्रत्येक पायरी fail करेल आणि TLS debugging मध्ये तासभर वाया घालवेल. लक्षणापासून कारणापर्यंतचा सर्वात जलद मार्ग म्हणजे ही शिडी, आणि ती laptop, VM आणि pod वर सारखीच आहे.

🔧 कसे (या repo मध्ये)

net/lab.sh HOST standard tools ने पायऱ्या 1–6 चालवतो आणि शेवटी triage चा क्रम छापतो; एखादे tool नसेल तर प्रत्येक पायरी पर्यायी मार्ग वापरते.

🧪 करून पाहा

bash net/lab.sh example.com
bash net/lab.sh nonexistent.example        # rung 1 fails: NXDOMAIN — stop there
bash net/lab.sh 203.0.113.1                # a documentation address: rung 2 fails — unreachable
bash net/lab.sh expired.badssl.com         # rungs 1–4 pass, rung 5 fails — the seal
sudo tcpdump -ni any 'port 53' -c 4 &  dig +short example.com    # optional: the directory question on the wire

✅ तपासा — तुम्हाला काय दिसायला हवे

example.com विरुद्ध प्रत्येक पायरी pass होते आणि curl HTTP/2 200 छापतो. प्रत्येक बिघडलेल्या host विरुद्ध नेमकी एकच पायरी आधी fail होते, आणि तिचा संदेश कारण सांगतो: NXDOMAIN, unreachable, certificate expired.

🏁 तुम्ही आत्ताच काय सिद्ध केले

कोणतेही "बंद पडले" घेऊन, दोन मिनिटांच्या आत, सात पैकी कोणती गोष्ट चुकली आहे ते तुम्ही सांगू शकता — ते सिद्ध करणाऱ्या command सह.

⚠️ नेहमीच्या चुका

पायरी 6 (curl -v) पासून सुरुवात करणे आणि TLS error ला app चा bug समजणे.
अडवलेल्या ping ला "unreachable" समजणे; अनेक hosts ICMP टाकून देतात — पायरी 4 वर जा.
शिडी चालवण्याआधीच गोष्टी restart करणे. तुम्ही पुरावा गमावता.

🏭 प्रत्यक्ष वापरात हे का महत्त्वाचे: हीच शिडी म्हणजे runbook. तुमची hostnames भरून ती on-call doc मध्ये ठेवा; पहिल्या responder ला पहाटे 3 वाजता ती आठवावी लागू नये.

🏆 Capstone

तुम्ही वापरत असलेल्या एका service साठी एका पानाचा runbook लिहा: तिचे नाव, पत्ता, port, certificate expiry, समोरचा load balancer, आणि प्रत्येकासाठी नेमक्या command सह सात पायऱ्या. मग मुद्दाम एक पायरी मोडा (चुकीची /etc/hosts नोंद, बंद port) आणि runbook ती शोधतो हे सिद्ध करा.

🎓 कोर्स पूर्ण झाला

अभ्यास योजना बारा धड्यांवर खूण करते; quiz ते तपासते; AWS शाळा ही इमारत तासाच्या भाड्याने देते, आणि School portal मध्ये certificate आहे.

🔧 Lesson 12 — Debugging the network: the triage ladder

📍 You are here: Lesson 12 of 12 · 🎓 The last one

📦 What's in this branch

Lessons 01–12 — the whole course. The ladder that turns "it's down" into a named cause, and the toolbox on each rung.

net/lab.sh — the ladder as one script: dig → ping → traceroute → nc → openssl → curl → who is listening
net/demo.py — every section is one rung, in Python

🧒 Explain like I'm 5

When a letter does not arrive, you do not shout at the building. You climb a ladder: Is the name in the directory? Can I reach the building at all? Which corridor goes wrong? Is the room open? Is the seal valid? Is the letter itself well-formed? Only then: what did the clerk write in the log? Each rung has one tool, and the first rung that fails names the cause.

🗺️ Diagram

flowchart LR
  A["1 DNS<br/>dig +short"] --> B["2 reach<br/>ping"] --> C["3 route<br/>traceroute"] --> D["4 port<br/>nc -zv"] --> E["5 TLS<br/>openssl s_client"] --> F["6 HTTP<br/>curl -v"] --> G["7 logs<br/>the app"]

❓ What

Rung	Question	Tool	The error that names it
1	is it DNS?	`dig +short`, `nslookup`	NXDOMAIN, stale address
2	can I reach it?	`ping`, `mtr`	100% loss (or ping blocked — check rung 4 anyway)
3	which corridor?	`traceroute`, `tracepath`	hops stop at one router
4	is the room open?	`nc -zv`, `ss -ltnp`	refused (empty) vs timed out (gate)
5	is the seal valid?	`openssl s_client`, `curl -v`	expired, wrong name, unknown CA
6	is the letter right?	`curl -v`, `tcpdump`	4xx your slip, 5xx their office, hang = no length
7	what happened inside?	the app's logs, request id	everything else

Latency vs bandwidth: ping measures latency (ms, distance, hops); a download measures bandwidth (Mbit/s). A slow site far away is latency; a slow big file is bandwidth.
tcpdump / Wireshark: read the envelopes themselves when nothing else explains it.

🤔 Why

Order matters: a DNS mistake will fail every later rung and waste an hour of TLS debugging. The ladder is the fastest path from symptom to cause, and it is the same on a laptop, a VM and a pod.

🔧 How (in this repo)

net/lab.sh HOST runs rungs 1–6 with the standard tools and prints the triage order at the end; each falls back when a tool is missing.

🧪 Try it

bash net/lab.sh example.com
bash net/lab.sh nonexistent.example        # rung 1 fails: NXDOMAIN — stop there
bash net/lab.sh 203.0.113.1                # a documentation address: rung 2 fails — unreachable
bash net/lab.sh expired.badssl.com         # rungs 1–4 pass, rung 5 fails — the seal
sudo tcpdump -ni any 'port 53' -c 4 &  dig +short example.com    # optional: the directory question on the wire

✅ Verify — what you should see

Against example.com every rung passes and curl prints HTTP/2 200. Against each broken host exactly one rung fails first, and its message names the cause: NXDOMAIN, unreachable, certificate expired.

🏁 What you just proved

You can take any "it's down" and, in under two minutes, say which of seven things is wrong — with the command that proved it.

⚠️ Common mistakes

Starting at rung 6 (curl -v) and reading a TLS error as an app bug.
Treating a blocked ping as "unreachable"; many hosts drop ICMP — go to rung 4.
Restarting things before running the ladder. You lose the evidence.

🏭 Why this matters in production: this ladder is the runbook. Put it in the on-call doc with your hostnames filled in; the first responder should never have to remember it at 3 a.m.

🏆 Capstone

Write a one-page runbook for a service you use: its name, address, port, certificate expiry, the load balancer in front, and the seven rungs with the exact command for each. Then break one rung on purpose (a wrong /etc/hosts entry, a closed port) and prove the runbook finds it.

🎓 The course is complete

The study plan ticks the twelve off; the quiz checks them; the AWS school rents this building by the hour, and the School portal has the certificate.

← Previousload balancers cdn Finished! Take the quiz →check what stuck

This page is the lesson's README from the lesson-12-debugging branch, shown here so the whole School stays on one site. Code files open on GitHub at the same branch.