Podman एजेंट

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

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

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

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

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

• Podman 4.0 या उसके बाद का संस्करण, और होस्ट पर root पहुँच।
• /run/podman/podman.sock पर Podman का API सॉकेट। इसे sudo systemctl enable --now podman.socket से चालू करें।
• एक इंजेशन कुंजी। प्रोजेक्ट सेटिंग्स → टेलीमेट्री और APM → इंजेशन कुंजियाँ के अंतर्गत एक बनाएँ और उसका मान कॉपी करें।
• होस्ट से आपके Status200 URL तक आउटबाउंड HTTPS।
• कंटेनर लॉग के लिए, ऐसे कंटेनर जो k8s-file लॉग ड्राइवर उपयोग करते हैं। rootful Podman डिफ़ॉल्ट रूप से journald में लॉग करता है, जिसे एजेंट नहीं पढ़ सकता। कंटेनर लॉग को k8s-file लॉग ड्राइवर चाहिए देखें।

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

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

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

   Podman CLIPodman Compose

   Podman CLI

   Bash

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

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

   Bash

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

   Podman Compose

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

   docker-compose.ymlYAML

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

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

   Bash

   podman compose up -d

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

   Bash

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

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

   Everything is ready. Begin running and processing data.

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

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

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

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

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

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

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

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

एजेंट /var/lib/containers/storage/overlay-containers/*/userdata/ctr.log फ़ॉलो करता है, यानी वे फ़ाइलें जो Podman का k8s-file लॉग ड्राइवर लिखता है (Podman में json-file वही ड्राइवर है)। rootful Podman का डिफ़ॉल्ट ड्राइवर journald है, जो पढ़ने के लिए कोई फ़ाइल नहीं छोड़ता, और syslog जैसा रिमोट ड्राइवर भी नहीं छोड़ता। ऐसे कंटेनर के मेट्रिक्स फिर भी आते हैं; उसके लॉग नहीं।

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

podman inspect <container> --format '{{.HostConfig.LogConfig.Type}}'
podman info --format '{{.Host.LogDriver}}'

किसी कंटेनर को k8s-file के साथ चलाएँ, या किसी Compose सेवा को उस पर ले जाएँ:

podman run --log-driver k8s-file --log-opt max-size=100m ... <image>

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

या containers.conf (rootful के लिए /etc/containers/containers.conf, rootless के लिए ~/.config/containers/containers.conf) में इसे बाद में बनने वाले हर कंटेनर का डिफ़ॉल्ट बनाएँ:

[containers]
log_driver = "k8s-file"
log_size_max = 104857600

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

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

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

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

podman compose pull
podman compose up -d

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

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

podman rm -f status200-podman-agent
podman rm -f status200-podman-ai-agent

podman compose down

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

AI एजेंट#

ऊपर के कमांड और Compose फ़ाइल, Podman एजेंट का install.sh और उसकी [PodmanAgent डायरेक्टरी](<YOUR_STATUS200_URL>/docs/static/scripts/agents/PodmanAgent) की docker-compose.yml, सभी Podman AI एजेंट चलाते हैं: एक दूसरा कंटेनर, status200-podman-ai-agent (इमेज status200/resource-ai-agent:release), जो वे केवल-पढ़ने वाले कमांड चलाता है जो Status200 AI इस होस्ट पर किसी घटना या अलर्ट की जाँच करते समय माँगता है — Podman के Docker-संगत API के ज़रिए, docker CLI से: docker ps -a, docker logs --tail 200 web, docker container inspect web — और सिर्फ़ आपकी अनुमति होने पर किसी नामित कंटेनर को फिर से शुरू करने जैसे सुधार लागू करता है। यह कलेक्टर वाले ही STATUS200_URL, STATUS200_SERVICE_TOKEN और PODMAN_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 क्या कर सकता है, एजेंट द्वारा सेट)।
• इसे कलेक्टर वाला ही सॉकेट चाहिए और यह उसे माउंट करके root के रूप में चलता है, क्योंकि सॉकेट का मालिक root है — और rootful Podman के लिए जो भी सॉकेट उपयोग कर सकता है वह इस होस्ट पर root है, :ro हो या न हो। एजेंट की कमांड नीति ही सीमा है: यह कभी exec, run, rm या prune नहीं चलाता, और कभी खुद को, कलेक्टर को या STATUS200_AI_PROTECTED_TARGETS (कंटेनर नाम ग्लोब) में की किसी चीज़ को नहीं बदलता।
• install.sh --no-ai-agent इसे छोड़ देता है; podman rm -f status200-podman-ai-agent इसे हटाता है। इसे कलेक्टर की तरह अपग्रेड करें: podman 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

curl -s -o /dev/null -D - --unix-socket /run/podman/podman.sock http://localhost/_ping | grep -i '^api-version'

podman run -d ... -e DOCKER_API_VERSION= ...

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

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

अगले कदम#