Docker एजेंट

Status200 Docker एजेंट एक कंटेनर है जिसे आप Docker होस्ट पर चलाते हैं। यह होस्ट के हर कंटेनर के आँकड़े और लॉग फ़ाइलें पढ़ता है और उन्हें Status200 को भेजता है, जहाँ होस्ट अपने कंटेनर, मेट्रिक्स और लॉग के साथ दिखता है। एक दूसरा कंटेनर, Docker AI एजेंट, Status200 AI को होस्ट की जाँच करने देता है। Docker मॉनिटर एजेंट के भेजे डेटा पर अलर्ट करते हैं।

यह कैसे काम करता है#

एजेंट एक OpenTelemetry Collector है जिसमें Status200 का कॉन्फ़िगरेशन पहले से बना हुआ है। Docker सॉकेट के ज़रिए यह हर 30 सेकंड में हर कंटेनर के आँकड़े पढ़ता है और हर 5 मिनट में हर कंटेनर, इमेज, नेटवर्क और वॉल्यूम की सूची बनाता है। यह कंटेनरों की लॉग फ़ाइलें फ़ॉलो करता है और सब कुछ आपकी दी गई इंजेशन कुंजी के साथ OTLP पर आपके Status200 URL को भेजता है।

होस्ट अपने पहले डेटा के साथ, DOCKER_HOST_NAME में आपके दिए नाम के अंतर्गत, खुद को रजिस्टर करता है। AI एजेंट वैकल्पिक है: उसे छोड़ दें, और कलेक्टर वैसे ही काम करता है।

शुरू करने से पहले#

• Docker Engine 20.10 या उसके बाद का संस्करण, और होस्ट पर root पहुँच: एजेंट /var/run/docker.sock पढ़ता है।
• Docker Compose v2 (docker compose कमांड), अगर आप Docker Compose से इंस्टॉल करते हैं।
• एक इंजेशन कुंजी। प्रोजेक्ट सेटिंग्स → टेलीमेट्री और APM → इंजेशन कुंजियाँ के अंतर्गत एक बनाएँ और उसका मान कॉपी करें।
• होस्ट से आपके Status200 URL तक आउटबाउंड HTTPS।
• कंटेनर लॉग के लिए, ऐसे कंटेनर जो Docker का json-file लॉग ड्राइवर उपयोग करते हैं, जो Docker का डिफ़ॉल्ट है। कंटेनर लॉग को json-file लॉग ड्राइवर चाहिए देखें।

एजेंट इंस्टॉल करें#

1. एजेंट शुरू करें#

   YOUR_STATUS200_URL को अपने Status200 URL से, YOUR_TELEMETRY_INGESTION_TOKEN को इंजेशन कुंजी से, और my-docker-host को इस होस्ट के किसी नाम से बदलें, जैसे prod-docker-01। होस्ट Status200 में इसी नाम से दिखता है, इसलिए इसे स्थिर रखें: नया नाम एक नया होस्ट रजिस्टर करता है।

   Docker CLIDocker Compose

   Docker CLI

   Bash

   docker run -d \
     --name status200-docker-agent \
     --user 0:0 \
     --restart unless-stopped \
     -v /var/run/docker.sock:/var/run/docker.sock:ro \
     -v /var/lib/docker/containers:/var/lib/docker/containers:ro \
     -e STATUS200_URL="YOUR_STATUS200_URL" \
     -e STATUS200_SERVICE_TOKEN="YOUR_TELEMETRY_INGESTION_TOKEN" \
     -e DOCKER_HOST_NAME="my-docker-host" \
     status200/docker-agent:release

   फिर उसी मानों के साथ उसके बगल में AI एजेंट शुरू करें। AI जाँच डिफ़ॉल्ट रूप से चालू है: जब Status200 AI इस होस्ट पर किसी घटना या अलर्ट की जाँच करता है, तो वह AI एजेंट के ज़रिए केवल-पढ़ने वाले docker कमांड चलाता है, और जब तक आप सुधारों की अनुमति न दें, कुछ नहीं बदलता। AI जाँच के बिना इंस्टॉल करने के लिए यह कमांड छोड़ दें।

   Bash

   docker run -d \
     --name status200-docker-ai-agent \
     --user 0:0 \
     --restart unless-stopped \
     --read-only --tmpfs /tmp \
     -v /var/run/docker.sock:/var/run/docker.sock:ro \
     -e STATUS200_URL="YOUR_STATUS200_URL" \
     -e STATUS200_SERVICE_TOKEN="YOUR_TELEMETRY_INGESTION_TOKEN" \
     -e STATUS200_AI_AGENT_RESOURCE_TYPE=docker \
     -e DOCKER_HOST_NAME="my-docker-host" \
     status200/resource-ai-agent:release

   Docker Compose

   इसे होस्ट के किसी फ़ोल्डर में docker-compose.yml के रूप में सहेजें। दूसरी सेवा AI एजेंट है: AI जाँच के बिना कलेक्टर चलाने के लिए उसे छोड़ दें।

   docker-compose.ymlYAML

   services:
     status200-docker-agent:
       image: status200/docker-agent:release
       container_name: status200-docker-agent
       user: "0:0"
       restart: unless-stopped
       volumes:
         - /var/run/docker.sock:/var/run/docker.sock:ro
         - /var/lib/docker/containers:/var/lib/docker/containers:ro
       environment:
         - STATUS200_URL=YOUR_STATUS200_URL
         - STATUS200_SERVICE_TOKEN=YOUR_TELEMETRY_INGESTION_TOKEN
         - DOCKER_HOST_NAME=my-docker-host
       logging:
         driver: json-file
         options:
           max-size: "10m"
           max-file: "3"
     status200-docker-ai-agent:
       image: status200/resource-ai-agent:release
       container_name: status200-docker-ai-agent
       user: "0:0"
       restart: unless-stopped
       read_only: true
       tmpfs:
         - /tmp
       volumes:
         - /var/run/docker.sock:/var/run/docker.sock:ro
       environment:
         - STATUS200_URL=YOUR_STATUS200_URL
         - STATUS200_SERVICE_TOKEN=YOUR_TELEMETRY_INGESTION_TOKEN
         - STATUS200_AI_AGENT_RESOURCE_TYPE=docker
         - DOCKER_HOST_NAME=my-docker-host

   उस फ़ोल्डर में इसे शुरू करें:

   Bash

   docker compose up -d

2. जाँचें कि एजेंट चल रहा है#

   Bash

   docker ps --filter name=status200-docker-agent
   docker logs -f status200-docker-agent

   कलेक्टर शुरू होने के बाद लॉग में यह लाइन दिखनी चाहिए:

   Everything is ready. Begin running and processing data.

3. Status200 में होस्ट खोजें#

   उत्पाद → बुनियादी ढांचा → Docker → सभी होस्ट खोलें। होस्ट लगभग एक मिनट में अपने DOCKER_HOST_NAME के अंतर्गत, अपने कंटेनर, मेट्रिक्स और लॉग के साथ दिखता है। AI एजेंट होस्ट के AI एजेंट पेज पर, और उसके अवलोकन में सबसे नीचे, कनेक्टेड दिखता है। होस्ट का टोपोलॉजी पेज उसके Compose प्रोजेक्ट, कंटेनर, इमेज, नेटवर्क और वॉल्यूम एक मैप पर दिखाता है: देखें टोपोलॉजी।

एनवायरनमेंट वेरिएबल#

कोई मान बदलने के लिए एजेंट हटाएँ और उसका कमांड फिर से चलाएँ (Docker CLI), या docker-compose.yml संपादित करें और docker compose up -d चलाएँ (Docker Compose)।

एजेंट क्या इकट्ठा करता है#

हर कंटेनर के मेट्रिक्स और लॉग उस कंटेनर के नाम वाली सेवा के अंतर्गत दर्ज होते हैं। हर लॉग लाइन को उसमें बताए स्तर से गंभीरता मिलती है, जैसे [ERROR], level=warn या {"level":"info"}; जो लाइन कोई स्तर नहीं बताती वह अपनी स्ट्रीम की गंभीरता लेती है: stderr ERROR है, stdout INFO। व्हाइटस्पेस या बंद कोष्ठक से शुरू होने वाली लाइनें पिछली लाइन से जुड़ जाती हैं, इसलिए स्टैक ट्रेस एक रिकॉर्ड के रूप में आता है। एजेंट के अपने लॉग छोड़ दिए जाते हैं।

Docker मॉनिटर हर मेट्रिक और उसका अर्थ सूचीबद्ध करता है।

कंटेनर लॉग को json-file लॉग ड्राइवर चाहिए#

एजेंट /var/lib/docker/containers/*/*-json.log फ़ॉलो करता है, यानी वे फ़ाइलें जो Docker का json-file लॉग ड्राइवर लिखता है। दूसरा ड्राइवर उपयोग करने वाला कंटेनर पढ़ने के लिए कोई फ़ाइल नहीं छोड़ता: local बाइनरी फ़ाइलें लिखता है, और journald, syslog, fluentd और gelf लॉग कहीं और भेजते हैं। उसके मेट्रिक्स फिर भी आते हैं; उसके लॉग नहीं।

किसी कंटेनर का लॉग ड्राइवर, और डेमन का डिफ़ॉल्ट, जाँचें:

docker inspect <container> --format '{{.HostConfig.LogConfig.Type}}'
docker info --format '{{.LoggingDriver}}'

किसी Compose सेवा को रोटेशन के साथ json-file पर ले जाएँ:

services:
  my-app:
    image: my-app:latest
    logging:
      driver: "json-file"
      options:
        max-size: "100m"
        max-file: "5"

या /etc/docker/daemon.json में इसे बाद में बनने वाले हर कंटेनर का डिफ़ॉल्ट बनाएँ:

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m",
    "max-file": "5"
  }
}

फिर Docker फिर से शुरू करें और कंटेनर दोबारा बनाएँ। कंटेनर वही लॉग ड्राइवर रखता है जिसके साथ वह बना था, इसलिए उसे फिर से शुरू करना काफ़ी नहीं।

एजेंट अपग्रेड करना#

जब एजेंट आपके Status200 से पुराना होता है, तो होस्ट के अवलोकन पर एजेंट संस्करण के बगल में एक चेतावनी चिह्न दिखता है। ये कमांड देखने के लिए उसे चुनें।

docker pull status200/docker-agent:release
docker pull status200/resource-ai-agent:release
docker rm -f status200-docker-agent status200-docker-ai-agent

docker compose pull
docker compose up -d

release टैग हमेशा सबसे नई रिलीज़ की ओर इंगित करता है। कोई संस्करण पिन करने के लिए status200/docker-agent:<version> उपयोग करें, जैसे status200/docker-agent:10.0.31। यही इमेज GitHub Container Registry पर ghcr.io/status200/docker-agent:release के रूप में है।

एजेंट अनइंस्टॉल करना#

docker rm -f status200-docker-agent
docker rm -f status200-docker-ai-agent

docker compose down

होस्ट अपने भेजे डेटा के साथ Status200 में बना रहता है। अगर अब आपको उसकी ज़रूरत नहीं, तो उसके मेनू में होस्ट हटाएं से उसे हटाएँ।

AI एजेंट#

ऊपर के कमांड और Compose फ़ाइल, Docker एजेंट का install.sh और उसकी [DockerAgent डायरेक्टरी](<YOUR_STATUS200_URL>/docs/static/scripts/agents/DockerAgent) की docker-compose.yml, सभी Docker AI एजेंट चलाते हैं: एक दूसरा कंटेनर, status200-docker-ai-agent (इमेज status200/resource-ai-agent:release), जो वे केवल-पढ़ने वाले docker कमांड चलाता है जो Status200 AI इस होस्ट पर किसी घटना या अलर्ट की जाँच करते समय माँगता है — docker ps -a, docker logs --tail 200 web, docker container inspect web, docker stats --no-stream — और सिर्फ़ आपकी अनुमति होने पर किसी नामित कंटेनर को फिर से शुरू करने जैसे सुधार लागू करता है। यह कलेक्टर वाले ही STATUS200_URL, STATUS200_SERVICE_TOKEN और DOCKER_HOST_NAME पढ़ता है, इसलिए ठीक इसी होस्ट की सेवा करता है, और Status200 में होस्ट के AI एजेंट पेज पर दिखता है।

• AI जाँच डिफ़ॉल्ट रूप से चालू है। एजेंट के कनेक्ट होते ही Status200 AI इस होस्ट की घटनाओं और अलर्ट की जाँच इसके साथ करता है, और होस्ट का अवलोकन एजेंट की स्थिति दिखाता है। रोकने के लिए, जहाँ एजेंट चलता है वहाँ STATUS200_AI_INVESTIGATION=false सेट करें (AI एजेंट पेज पर AI क्या कर सकता है के अंतर्गत बदलें तरीका दिखाता है), या एजेंट को छोड़ दें।
• यह केवल-पढ़ने वाला है, जब तक आप इसे STATUS200_AI_ALLOW_WRITES=true के साथ शुरू न करें; STATUS200_AI_WRITE_TARGETS (उदाहरण के लिए web-*,api-*) सीमित करता है कि कोई सुधार किन कंटेनरों को छू सकता है। सुधार कैसे चलें यह बताने के लिए इसे STATUS200_AI_FIXES के साथ भी शुरू करें — ask-for-approval (हर एक को एक व्यक्ति मंज़ूरी देता है), automatic या bypass-approval — और AI एजेंट पेज इसे केवल-पढ़ने के रूप में दिखाता है (AI क्या कर सकता है, एजेंट द्वारा सेट)।
• यह Docker सॉकेट माउंट करके root के रूप में चलता है, क्योंकि सॉकेट का मालिक root है — और जो भी सॉकेट उपयोग कर सकता है वह इस होस्ट पर root है, :ro हो या न हो। एजेंट की कमांड नीति ही सीमा है: यह कभी exec, run, rm या prune नहीं चलाता, और कभी खुद को, कलेक्टर को या STATUS200_AI_PROTECTED_TARGETS (कंटेनर नाम ग्लोब) में की किसी चीज़ को नहीं बदलता। होस्ट से कुछ भी बाहर जाने से पहले docker inspect आउटपुट के एनवायरनमेंट मान छिपा दिए जाते हैं।
• install.sh --no-ai-agent इसे छोड़ देता है; docker rm -f status200-docker-ai-agent इसे हटाता है। इसे कलेक्टर की तरह अपग्रेड करें: docker pull status200/resource-ai-agent:release, इसे हटाएँ, और फिर से शुरू करें।

यह क्या चला सकता है, सुधार कैसे काम करते हैं और इसकी समस्याएँ कैसे सुलझाएँ: Infrastructure AI Agents।

समस्या निवारण#

Error: cannot start pipelines: failed to start "docker_stats" receiver:
Error response from daemon: client version 1.44 is too new.
Maximum supported API version is 1.41

docker version --format '{{ .Server.APIVersion }}'

docker run -d ... -e DOCKER_API_VERSION= ...

docker logs status200-docker-agent 2>&1 | grep -E "Started watching file|no files match"
docker inspect <container> --format '{{.HostConfig.LogConfig.Type}}'

docker inspect status200-docker-agent --format '{{range .Config.Env}}{{println .}}{{end}}' | grep DOCKER_HOST_NAME

अगले कदम#