Terraform 0.11

circonus_check




terraform

circonus_check

circonus_check संसाधन बनाता है और Circonus चेक का प्रबंधन करता है।

प्रयोग

variable api_token {
  default = "my-token"
}

resource "circonus_check" "usage" {
  name = "Circonus Usage Check"

  notes = <<-EOF
A check to extract a usage metric.
EOF

  collector {
    id = "/broker/1"
  }

  metric {
    name = "${circonus_metric.used.name}"
    tags = "${circonus_metric.used.tags}"
    type = "${circonus_metric.used.type}"
    unit = "${circonus_metric.used.unit}"
  }

  json {
    url = "https://api.circonus.com/v2"

    http_headers = {
      Accept                = "application/json"
      X-Circonus-App-Name   = "TerraformCheck"
      X-Circonus-Auth-Token = "${var.api_token}"
    }
  }

  period       = 60
  tags         = ["source:circonus", "author:terraform"]
  timeout      = 10
}

resource "circonus_metric" "used" {
  name = "_usage`0`_used"
  type = "numeric"
  unit = "qty"

  tags = {
    source = "circonus"
  }
}

तर्क संदर्भ

  • active - (वैकल्पिक) चेक सक्षम है या नहीं (डिफ़ॉल्ट true )।

  • caql - (वैकल्पिक) एक सर्कोनस एनालिटिक्स क्वेरी लैंग्वेज (CAQL) चेक। एक caql जांच को कॉन्फ़िगर करने के तरीके के विवरण के लिए नीचे देखें।

  • cloudwatch - (वैकल्पिक) एक क्लाउडवॉच चेक चेक। cloudwatch चेक को कॉन्फ़िगर करने के तरीके के विवरण के लिए नीचे देखें।

  • collector - (आवश्यक) एक कलेक्टर आईडी। कलेक्टर (s) जो एक circonus_check को चलाने के लिए जिम्मेदार हैं। id क्लाउड में चलने वाले Circonus कलेक्टर (उर्फ "ब्रोकर") या आपके डेटासेंटर में चलने वाले एंटरप्राइज़ कलेक्टर के लिए Circonus ID हो सकती है। निर्दिष्ट प्रत्येक collector के लिए मैट्रिक्स का एक संग्रह स्वचालित रूप से बनाया जाएगा।

  • consul - (वैकल्पिक) एक देशी कांसुल चेक। एक consul चेक को कॉन्फ़िगर करने के तरीके के विवरण के लिए नीचे देखें।

  • http - (वैकल्पिक) एक पोल-आधारित HTTP चेक। http चेक को कॉन्फ़िगर करने के तरीके के विवरण के लिए नीचे देखें।

  • httptrap - (वैकल्पिक) एक पुश-आधारित HTTP चेक। यह जाँच विधि ग्राहकों को विशेष रूप से तैयार HTTP JSON पेलोड भेजने की उम्मीद करती है। नीचे दिए गए विवरणों को कॉन्फ़िगर करने के तरीके के विवरण के लिए नीचे देखें।

  • icmp_ping - (वैकल्पिक) एक ICMP पिंग चेक। icmp_ping चेक को कॉन्फ़िगर करने के तरीके के विवरण के लिए नीचे देखें।

  • json - (वैकल्पिक) एक JSON चेक। json चेक को कैसे कॉन्फ़िगर करें, इसके विवरण के लिए नीचे देखें।

  • metric - (आवश्यक) एक या अधिक metric कॉन्फ़िगरेशन की सूची। इस जाँच उदाहरण से प्राप्त सभी मीट्रिक व्यक्तिगत मीट्रिक धाराओं के रूप में उपलब्ध होंगे। समर्थित metric अट्रिब्यूट्स की सूची के लिए नीचे देखें।

  • metric_limit - (वैकल्पिक) एक मीट्रिक सीमा निर्धारित करने से Circonus बैकेंड को समय-समय पर चेक को देखने के लिए बताएगा कि क्या अतिरिक्त मैट्रिक्स हैं कलेक्टर ने देखा है कि हमें इकट्ठा करना चाहिए। यह पहले एकत्र किए गए मैट्रिक्स को फिर से सक्रिय नहीं करेगा और फिर निष्क्रिय के रूप में चिह्नित किया जाएगा। मान 0 से अक्षम करने के लिए, -1 हैं, सभी मैट्रिक्स या N+ को सक्षम करने के लिए मान N (दोनों -1 और N+ खाते की अन्य प्रतिबंधों से अधिक नहीं हो सकते हैं) को इकट्ठा करने के लिए।

  • mysql - (वैकल्पिक) एक MySQL जांच। mysql चेक को कॉन्फ़िगर करने के तरीके के विवरण के लिए नीचे देखें।

  • name - (वैकल्पिक) वेब इंटरफेस में प्रदर्शित होने वाले चेक का नाम।

  • notes - (वैकल्पिक) इस चेक के बारे में नोट्स।

  • period - (वैकल्पिक) प्रत्येक बार चेक के बीच की अवधि सेकंड में बनाई जाती है।

  • postgresql - (वैकल्पिक) एक PostgreSQL चेक। postgresql चेक को कॉन्फ़िगर करने के तरीके के विवरण के लिए नीचे देखें।

  • statsd - (वैकल्पिक) एक आँकड़ों की जाँच। statsd जाँच को कॉन्फ़िगर कैसे करें के विवरण के लिए नीचे देखें।

  • tags - (वैकल्पिक) इस चेक को सौंपे गए टैग की एक सूची।

  • target - (आवश्यक) एक स्ट्रिंग जिसमें जाँच की जा रही चीज़ का स्थान हो। यह मान चेक प्रकार के आधार पर बदलता है। उदाहरण के लिए, http चेक प्रकार के लिए यह वह URL होगा जो आप चेक कर रहे हैं। DNS चेक के लिए यह होस्टनाम होगा जिसे आप देखना चाहते हैं।

  • tcp - (वैकल्पिक) एक टीसीपी चेक। tcp चेक को कॉन्फ़िगर करने के तरीके (TLS सपोर्ट सहित) के विवरण के लिए नीचे देखें।

  • timeout - (वैकल्पिक) एक फ्लोटिंग पॉइंट संख्या जो इस चेक की अधिकतम संख्या को दर्शाता है, परिणाम के लिए इंतजार करना चाहिए। चूक से 10.0

समर्थित metric गुण

निम्नलिखित विशेषताएँ एक metric भीतर उपलब्ध हैं।

  • active - (वैकल्पिक) मेट्रिक सक्रिय है या नहीं। true अवहेलना।
  • name - (वैकल्पिक) मीट्रिक का नाम। एक स्ट्रिंग जिसमें फ्रीफ़ॉर्म टेक्स्ट होता है।
  • tags - (वैकल्पिक) मीट्रिक को सौंपे गए टैग की एक सूची।
  • type - (आवश्यक) एक स्ट्रिंग जिसमें numeric , text , histogram , composite , या caql
  • units - (वैकल्पिक) माप की इकाई मीट्रिक का प्रतिनिधित्व करती है (जैसे, बाइट्स, सेकंड, मिलीसेकंड)। एक स्ट्रिंग जिसमें फ्रीफ़ॉर्म टेक्स्ट होता है।

समर्थित प्रकार की जाँच करें

Circonus विभिन्न जाँचों का समर्थन करता है। प्रत्येक चेक प्रकार के पास विकल्पों का अपना सेट होता है जिसे कॉन्फ़िगर किया जाना चाहिए। प्रत्येक चेक प्रकार हर दूसरे चेक प्रकार के साथ टकराव होता है (यानी एक json चेक के लिए कॉन्फ़िगर किया गया circonus_check अन्य सभी चेक प्रकारों के साथ संघर्ष करेगा, इसलिए एक postgresql चेक एक अलग circonus_check संसाधन होना चाहिए)।

caql चेक प्रकार विशेषताएँ

उपलब्ध मेट्रिक्स caql चेक में दिए गए पेलोड पर निर्भर करते हैं। अतिरिक्त विवरण के लिए caql चेक प्रकार देखें।

cloudwatch चेक प्रकार विशेषताएँ

  • api_key - (आवश्यक) AWS पहुंच कुंजी। यदि यह मान स्पष्ट रूप से सेट नहीं किया गया है, तो यह मान वातावरण चर AWS_ACCESS_KEY_ID द्वारा पॉप्युलेट किया जाता है।

  • api_secret - (आवश्यक) AWS गुप्त कुंजी। यदि यह मान स्पष्ट रूप से सेट नहीं किया गया है, तो यह मान पर्यावरण चर AWS_SECRET_ACCESS_KEY द्वारा पॉप्युलेट किया जाता है।

  • dimmensions - (आवश्यक) चेक में शामिल करने के लिए CloudWatch dimmensions का एक नक्शा।

  • metric - (आवश्यक) इस जाँच में एकत्र करने के लिए मीट्रिक नामों की एक सूची।

  • namespace - (आवश्यक) पैरामीटर से खींचने के लिए नाम स्थान।

  • url - (आवश्यक) AWS URL से खींचने के लिए। इसे क्षेत्र-विशिष्ट समापन बिंदु पर सेट किया जाना चाहिए (उदाहरण के लिए https://monitoring.us-east-1.amazonaws.com पर पसंद https://monitoring.amazonaws.com )।

  • version - (वैकल्पिक) क्लाउडवॉच एपीआई के संस्करण का उपयोग करने के लिए। 2010-08-01 लिए चूक।

उपलब्ध मीट्रिक cloudwatch चेक में दिए गए पेलोड पर निर्भर करते हैं। अतिरिक्त विवरण के लिए cloudwatch चेक प्रकार देखें। CloudWatch मैट्रिक्स के लिए circonus_check period विशेषता को 60s या 300s 60s सेट किया जाना चाहिए।

उदाहरण CloudWatch जाँच (आंशिक मैट्रिक्स संग्रह):

variable "cloudwatch_rds_tags" {
  type = "list"
  default = [
    "app:postgresql",
    "app:rds",
    "source:cloudwatch",
  ]
}

resource "circonus_check" "rds_metrics" {
  active = true
  name = "Terraform test: RDS Metrics via CloudWatch"
  notes = "Collect RDS metrics"
  period = "60s"

  collector {
    id = "/broker/1"
  }

  cloudwatch {
    dimmensions = {
      DBInstanceIdentifier = "my-db-name",
    }

    metric = [
      "CPUUtilization",
      "DatabaseConnections",
    ]

    namespace = "AWS/RDS"
    url = "https://monitoring.us-east-1.amazonaws.com"
  }

  metric {
    name = "CPUUtilization"
    tags = [ "${var.cloudwatch_rds_tags}" ]
    type = "numeric"
    unit = "%"
  }

  metric {
    name = "DatabaseConnections"
    tags = [ "${var.cloudwatch_rds_tags}" ]
    type = "numeric"
    unit = "connections"
  }
}

consul चेक प्रकार विशेषताएँ

  • acl_token - (वैकल्पिक) एक एसीएल टोकन एपीआई अनुरोध को प्रमाणित करता है। जब एक ACL टोकन सेट किया जाता है, तो यह मान HTTP हैडर के रूप में किसी भी लॉग में नहीं दिखाने के लिए प्रसारित किया जाता है। डिफ़ॉल्ट मान एक रिक्त स्ट्रिंग है।

  • allow_stale - (वैकल्पिक) एक बूलियन मान जो इंगित करता है कि इस चेक को स्वास्थ्य नेता की allow_stale आवश्यकता है या नहीं। स्केलेबिलिटी कारणों के लिए, यह मान false को false । स्वास्थ्य जानकारी की गति का पता लगाने के विवरण के लिए नीचे देखें।

  • ca_chain - (वैकल्पिक) फ़ाइल का एक पथ जिसमें सभी प्रमाणपत्र प्राधिकारी होते हैं जिन्हें दूरस्थ प्रमाणपत्र को सत्यापित करने के लिए लोड किया जाना चाहिए (जब http_addr एक http_addr सक्षम समापन बिंदु है)।

  • certificate_file - (वैकल्पिक) क्लाइंट सर्टिफिकेट वाली फाइल का एक पथ जो दूरस्थ सर्वर को प्रस्तुत किया जाएगा (जब http_addr एक http_addr सक्षम समापन बिंदु है)।

  • check_blacklist - (वैकल्पिक) चेकों के परिणाम से बाहर करने के लिए चेक नामों की एक सूची (यानी जिसका चेक नाम check_blacklist में है, कोई मेट्रिक्स उत्पन्न नहीं होगा)। यह ब्लैकलिस्ट node , service और state चेक मोड पर लागू होता है।

  • ciphers - (वैकल्पिक) TLS प्रोटोकॉल में उपयोग किए जाने वाले ciphers की एक सूची (केवल जब http_addr एक http_addr सक्षम समापन बिंदु होता है)।

  • dc - (वैकल्पिक) स्पष्ट रूप से उपयोग करने के लिए कंसुल डेटासेंटर का नाम बताइए। डिफ़ॉल्ट मान एक रिक्त स्ट्रिंग है। जब कोई खाली मान निर्दिष्ट किया जाता है, तो http_addr पर एजेंट के कॉन्सल डेटासेंटर का उपयोग किया जाता है।

  • headers - (वैकल्पिक) चेक का निष्पादन करते समय HTTP हेडर का एक नक्शा भेजा जाना। नोट: headers विशेषता को अंतिम रूप से संसाधित किया जाता है और यह किसी अन्य व्युत्पन्न मान पर पूर्वाभास लेगा, जो एक HTTP हेडर के रूप में कॉन्सुल में प्रेषित होता है (अर्थात हेडर मान सेट करके acl_token को ओवरराइड करना संभव है)।

  • http_addr - (वैकल्पिक) स्वास्थ्य सूचना के लिए क्वेरी करने के लिए कौंसल HTTP समापन बिंदु। डिफ़ॉल्ट मान http://consul.service.consul:8500 । जब समापन बिंदु TLS- सक्षम हो, तो स्कीम को http से https बदलना होगा।

  • key_file - (वैकल्पिक) एक फ़ाइल का पथ जिसमें कुंजी प्रमाणपत्र के साथ संयोजन में उपयोग किया जाना है (आवश्यक है जब http_addr एक http_addr सक्षम समापन बिंदु है)।

  • node - (वैकल्पिक) इस नोड के स्वास्थ्य की जाँच करें। मान या तो एक कॉनसोल नोड आईडी (कॉन्सल संस्करण> = 0.7.4) या नोड नाम हो सकता है। यह भी देखें कि service_blacklist , node_blacklist और check_blacklist विशेषताएँ। यह विशेषता service और state विशेषताओं के साथ टकराव करती है।

  • node_blacklist - (वैकल्पिक) चेक के परिणामों से बाहर करने के लिए नोड आईडी या नोड नामों की एक सूची (यानी node_blacklist में कोई मैट्रिक्स उत्पन्न नहीं होगी)। यह ब्लैकलिस्ट node , service और state चेक मोड पर लागू होता है।

  • service - (वैकल्पिक) इस नामित सेवा के क्लस्टर-वाइड स्वास्थ्य की जाँच करें। यह भी देखें कि service_blacklist , node_blacklist और check_blacklist विशेषताएँ। यह विशेषता node और state विशेषताओं के साथ टकराव करती है।

  • service_blacklist - (वैकल्पिक) चेक के परिणाम से बाहर करने के लिए सेवा के नामों की एक सूची (अर्थात ऐसी कोई मीट्रिक सेवाओं के द्वारा उत्पन्न नहीं की जाएगी, जिनका सेवा नाम service_blacklist )। यह ब्लैकलिस्ट node , service और state चेक मोड पर लागू होता है।

  • state - (वैकल्पिक) पूरे कॉन्सुल क्लस्टर में कॉन्सल चेक की निगरानी के लिए एक सर्कोनस चेक। यह मान या तो passing , warning या critical हो सकता है। यह consul चेक मोड अंतिम उपाय के क्लस्टर चेक के रूप में कार्य करने का इरादा है। यह चेक प्रकार तब उपयोगी होता है जब पहली बार शुरू किया जाता है और इसका उद्देश्य व्यक्तिगत सेवाओं या नोड्स के लिए स्पष्ट रूप से परिभाषित चेक में संक्रमण करने से पहले अंतिम उपाय के चेक के रूप में कार्य करना होता है। चेक से लौटाए गए मेट्रिक्स को एंट्री के CreateIndex के आधार पर सॉर्ट किया जाएगा ताकि रिटर्न वैल्यूज़ के एरे में मेट्रिक्स का एक स्थिर सेट हो। यह भी देखें कि service_blacklist , node_blacklist और check_blacklist विशेषताएँ। यह विशेषता node और state विशेषताओं के साथ टकराव करती है।

उपलब्ध मेट्रिक्स कांसुल चेक (प्रदर्शन, service , या state ) पर निर्भर करता है। एंडपॉइंट्स से उपलब्ध डेटा के अलावा, consul चेक मेट्रिक्स का एक सेट भी लौटाता है जो इसका एक प्रकार है: {Num,Pct}{,Passing,Warning,Critical}{Checks,Nodes,Services} ( GLOB_BRACE अनुभाग देखें {Num,Pct}{,Passing,Warning,Critical}{Checks,Nodes,Services} आपके स्थानीय glob(3) प्रलेखन)।

उदाहरण कॉन्सल चेक (आंशिक मैट्रिक्स संग्रह):

resource "circonus_check" "consul_server" {
  active = true
  name = "%s"
  period = "60s"

  collector {
    # Collector ID must be an Enterprise broker able to reach the Consul agent
    # listed in `http_addr`.
    id = "/broker/2110"
  }

  consul {
    service = "consul"

    # Other consul check modes:
    # node = "consul1"
    # state = "critical"
  }

  metric {
    name = "NumNodes"
    tags = [ "source:consul", "lifecycle:unittest" ]
    type = "numeric"
  }

  metric {
    name = "LastContact"
    tags = [ "source:consul", "lifecycle:unittest" ]
    type = "numeric"
    unit = "seconds"
  }

  metric {
    name = "Index"
    tags = [ "source:consul", "lifecycle:unittest" ]
    type = "numeric"
    unit = "transactions"
  }

  metric {
    name = "KnownLeader"
    tags = [ "source:consul", "lifecycle:unittest" ]
    type = "text"
  }

  tags = [ "source:consul", "lifecycle:unittest" ]
}

http चेक प्रकार विशेषताएँ

  • auth_method - (वैकल्पिक) HTTP प्रमाणीकरण विधि का उपयोग करने के लिए। जब सेट Basic , Digest या Auto से एक मान होना चाहिए।

  • प्रमाणीकरण के दौरान उपयोग करने का पासवर्ड।

  • auth_user - (वैकल्पिक) उपयोगकर्ता के रूप में प्रमाणित करने के लिए।

  • body_regexp - (वैकल्पिक) यह नियमित अभिव्यक्ति प्रतिक्रिया के शरीर के साथ मेल खाती है। यदि एक मैच नहीं मिला है, तो चेक को "खराब" के रूप में चिह्नित किया जाएगा।

  • ca_chain - (वैकल्पिक) फ़ाइल का एक पथ जिसमें सभी प्रमाणपत्र प्राधिकारी होते हैं जिन्हें दूरस्थ प्रमाणपत्र (TLS जांच के लिए) को मान्य करने के लिए लोड किया जाना चाहिए।

  • certificate_file - (वैकल्पिक) क्लाइंट सर्टिफिकेट वाली फाइल का एक पथ जो दूरस्थ सर्वर (टीएलएस चेक के लिए) को प्रस्तुत किया जाएगा।

  • ciphers - (वैकल्पिक) TLS प्रोटोकॉल में उपयोग किए जाने वाले ciphers की एक सूची (HTTPS चेक के लिए)।

  • code - (वैकल्पिक) HTTP कोड जो अपेक्षित है। यदि प्राप्त कोड इस नियमित अभिव्यक्ति से मेल नहीं खाता है, तो चेक को "खराब" के रूप में चिह्नित किया गया है।

  • extract - (वैकल्पिक) यह नियमित अभिव्यक्ति विश्व स्तर पर प्रतिक्रिया के शरीर के खिलाफ मेल खाती है। पहला कैप्चरिंग मैच कुंजी है और दूसरा कैप्चरिंग मैच मान है। निकाले गए प्रत्येक कुंजी / मूल्य को चेक के लिए मीट्रिक के रूप में पंजीकृत किया जाता है।

  • headers - (वैकल्पिक) चेक का निष्पादन करते समय HTTP हेडर का एक नक्शा भेजा जाना।

  • key_file - (वैकल्पिक) फ़ाइल का एक पथ जिसमें कुंजी प्रमाणपत्र (TLS जांच के लिए) के साथ संयोजन में उपयोग किया जाना है।

  • method - (वैकल्पिक) HTTP विधि का उपयोग करने के लिए। जीएटी की GET

  • payload - (वैकल्पिक) HTTP अनुरोध के पेलोड के रूप में हस्तांतरित जानकारी।

  • read_limit - (वैकल्पिक) डेटा रीड पर एक अनुमानित सीमा सेट करता है ( 0 अर्थ है कोई सीमा नहीं)। डिफ़ॉल्ट 0

  • redirects - (वैकल्पिक) HTTP Location हेडर की अधिकतम संख्या का पालन करने के लिए रीडायरेक्ट करता है। डिफ़ॉल्ट 0

  • url - (आवश्यक) इस json चेक के लिए लक्ष्य। url में स्कीम, होस्ट, पोर्ट (वैकल्पिक) और उपयोग करने के लिए पथ (जैसे https://app1.example.org/healthz ) शामिल होना चाहिए

  • version - (वैकल्पिक) HTTP संस्करण का उपयोग करने के लिए। 1.1 चूक।

उपलब्ध मैट्रिक्स में शामिल हैं: body_match , bytes , cert_end , cert_end_in , cert_error , cert_issuer , cert_start , cert_subject , code , tt_connect , truncated , tt_connect और tt_firstbyte । अतिरिक्त विवरण के लिए http चेक प्रकार देखें।

httptrap चेक प्रकार विशेषताएँ

  • async_metrics - (वैकल्पिक) बूलियन मान निर्दिष्ट करता है कि क्या नॉटप्रेप मेट्रिक्स तुरंत लॉग इन किया जाता है या तब तक आयोजित किया जाता है जब तक स्थिति संदेश उत्सर्जित नहीं किया जाता है। डिफ़ॉल्ट false

  • secret - (ऑप्शनल) वह रहस्य निर्दिष्ट करें जिसके साथ मेट्रिक्स सबमिट किए जा सकते हैं।

उपलब्ध मेट्रिक्स httptrap डॉक में दिए गए पेलोड पर निर्भर करते हैं। अतिरिक्त विवरणों के लिए httptrap चेक प्रकार देखें।

json चेक प्रकार विशेषताएँ

  • auth_method - (वैकल्पिक) HTTP प्रमाणीकरण विधि का उपयोग करने के लिए। जब सेट Basic , Digest या Auto से एक मान होना चाहिए।

  • प्रमाणीकरण के दौरान उपयोग करने का पासवर्ड।

  • auth_user - (वैकल्पिक) उपयोगकर्ता के रूप में प्रमाणित करने के लिए।

  • ca_chain - (वैकल्पिक) फ़ाइल का एक पथ जिसमें सभी प्रमाणपत्र प्राधिकारी होते हैं जिन्हें दूरस्थ प्रमाणपत्र (TLS जांच के लिए) को मान्य करने के लिए लोड किया जाना चाहिए।

  • certificate_file - (वैकल्पिक) क्लाइंट सर्टिफिकेट वाली फाइल का एक पथ जो दूरस्थ सर्वर (टीएलएस चेक के लिए) को प्रस्तुत किया जाएगा।

  • ciphers - (वैकल्पिक) TLS प्रोटोकॉल में उपयोग किए जाने वाले ciphers की एक सूची (HTTPS चेक के लिए)।

  • headers - (वैकल्पिक) चेक का निष्पादन करते समय HTTP हेडर का एक नक्शा भेजा जाना।

  • key_file - (वैकल्पिक) फ़ाइल का एक पथ जिसमें कुंजी प्रमाणपत्र (TLS जांच के लिए) के साथ संयोजन में उपयोग किया जाना है।

  • method - (वैकल्पिक) HTTP विधि का उपयोग करने के लिए। जीएटी की GET

  • port - (वैकल्पिक) उपयोग करने के लिए टीसीपी पोर्ट नंबर। 81 चूक।

  • read_limit - (वैकल्पिक) डेटा रीड पर एक अनुमानित सीमा सेट करता है ( 0 अर्थ है कोई सीमा नहीं)। डिफ़ॉल्ट 0

  • redirects - (वैकल्पिक) HTTP Location हेडर की अधिकतम संख्या का पालन करने के लिए रीडायरेक्ट करता है। डिफ़ॉल्ट 0

  • url - (आवश्यक) इस json चेक के लिए लक्ष्य। url में स्कीम, होस्ट, पोर्ट (वैकल्पिक) और उपयोग करने के लिए पथ (जैसे https://app1.example.org/healthz ) शामिल होना चाहिए

  • version - (वैकल्पिक) HTTP संस्करण का उपयोग करने के लिए। 1.1 चूक।

उपलब्ध मीट्रिक json डॉक्टर में दिए गए पेलोड पर निर्भर करते हैं। अतिरिक्त विवरण के लिए json चेक प्रकार देखें।

icmp_ping चेक प्रकार विशेषताएँ

icmp_ping चेक को सेट करने के लिए target शीर्ष-स्तरीय विशेषता की आवश्यकता होती है।

  • availability - (वैकल्पिक) पिंग पैकेट का प्रतिशत जो इस माप के सफल होने के लिए वापस किया जाना चाहिए। 100.0
  • count - (वैकल्पिक) भेजने के लिए ICMP पिंग पैकेट की संख्या। 5 चूक।
  • interval - (वैकल्पिक) पैकेट के बीच अंतराल। डिफॉल्ट्स टू 2s

उपलब्ध मीट्रिक में शामिल हैं: available , average , count , maximum और minimum । अतिरिक्त विवरण के लिए ping_icmp चेक प्रकार देखें।

mysql चेक प्रकार विशेषताएँ

mysql चेक को सेट करने के लिए target शीर्ष-स्तरीय विशेषता की आवश्यकता होती है।

postgresql चेक प्रकार विशेषताएँ

postgresql चेक को सेट करने के लिए target शीर्ष-स्तरीय विशेषता की आवश्यकता होती है।

उपलब्ध मीट्रिक नाम query रन होने के आउटपुट पर निर्भर हैं।

statsd जाँच प्रकार विशेषताएँ

  • source_ip - (आवश्यक) इस आईपी पते (IPv4 या IPv6) से कोई भी आँकड़े संदेश इस चेक से संबद्ध होंगे।

उपलब्ध मैट्रिक्स statsd जांच के लिए भेजे गए मीट्रिक पर निर्भर करते हैं।

tcp चेक प्रकार विशेषताएँ

  • banner_regexp - (वैकल्पिक) इस रेगुलर एक्सप्रेशन का मिलान बैनर के विरुद्ध किया जाता है। यदि एक मैच नहीं मिला है, तो चेक को खराब के रूप में चिह्नित किया जाएगा।

  • ca_chain - (वैकल्पिक) फ़ाइल का एक पथ जिसमें सभी प्रमाणपत्र प्राधिकारी होते हैं जिन्हें दूरस्थ प्रमाणपत्र (TLS जांच के लिए) को मान्य करने के लिए लोड किया जाना चाहिए।

  • certificate_file - (वैकल्पिक) क्लाइंट सर्टिफिकेट वाली फाइल का एक पथ जो दूरस्थ सर्वर (टीएलएस चेक के लिए) को प्रस्तुत किया जाएगा।

  • ciphers - (वैकल्पिक) TLS प्रोटोकॉल में उपयोग किए जाने वाले ciphers की एक सूची (HTTPS चेक के लिए)।

  • host - (आवश्यक) होस्टनाम या कनेक्ट करने के लिए होस्ट का आईपी पता।

  • key_file - (वैकल्पिक) फ़ाइल का एक पथ जिसमें कुंजी प्रमाणपत्र (TLS जांच के लिए) के साथ संयोजन में उपयोग किया जाना है।

  • port - (आवश्यक) पूर्णांक उस पोर्ट को निर्दिष्ट करता है जिस पर प्रबंधन इंटरफ़ेस पहुँच सकता है।

  • tls - (वैकल्पिक) जब टीएलएस कनेक्शन स्थापित करने में सक्षम हो।

उपलब्ध मीट्रिक में शामिल हैं: banner , banner_match , cert_end , cert_end_in , cert_error , cert_issuer , cert_start , cert_subject , duration , tt_connect , tt_firstbyte । अतिरिक्त विवरण के लिए tcp चेक प्रकार देखें।

नमूना tcp जाँच:

resource "circonus_check" "tcp_check" {
  name = "TCP and TLS check"
  notes = "Obtains the connect time and TTL for the TLS cert"
  period = "60s"

  collector {
    id = "/broker/1"
  }

  tcp {
    host = "127.0.0.1"
    port = 443
    tls = true
  }

  metric {
    name = "cert_end_in"
    tags = [ "${var.tcp_check_tags}" ]
    type = "numeric"
    unit = "seconds"
  }

  metric {
    name = "tt_connect"
    tags = [ "${var.tcp_check_tags}" ]
    type = "numeric"
    unit = "miliseconds"
  }

  tags = [ "${var.tcp_check_tags}" ]
}

पैरामीटर्स से बाहर

  • check_by_collector - कलेक्टर ( check_by_collector , मैप की) की ID को check_id (मान) में दर्ज करता है जो एक कलेक्टर को पंजीकृत है।

  • check_id - यदि चेक के लिए केवल एक collector निर्दिष्ट है, तो यह मान check_id साथ पॉप्युलेट हो जाएगा। यदि चेक में एक से अधिक collector निर्दिष्ट हैं, तो यह मान एक रिक्त स्ट्रिंग होगा। check_by_collector हमेशा आबाद रहेगा।

  • checks - इस circonus_check द्वारा बनाई गई check_id सूची। चेक में निर्दिष्ट प्रति कलेक्टर इस सूची में एक तत्व है।

  • created - UNIX समय जिस पर यह चेक बनाया गया था।

  • last_modified - UNIX समय जिस पर यह चेक अंतिम बार संशोधित किया गया था।

  • last_modified_by - last_modified_by उपयोगकर्ता आईडी जिसने इस चेक को अंतिम रूप से संशोधित किया है।

  • Rev_connect_urls - केवल Circonus समर्थन के लिए प्रासंगिक है।

  • uuids - इस circonus_check द्वारा बनाई गई चेक uuid s की सूची। चेक में निर्दिष्ट प्रति कलेक्टर इस सूची में एक तत्व है।

आयात उदाहरण

circonus_check आयात करने वाले संसाधनों का समर्थन करता है। निम्नलिखित टेराफ़ॉर्म (और संदर्भित circonus_metric पहले से ही आयात किया गया है)

provider "circonus" {
  alias = "b8fec159-f9e5-4fe6-ad2c-dc1ec6751586"
}

resource "circonus_metric" "used" {
  name = "_usage`0`_used"
  type = "numeric"
}

resource "circonus_check" "usage" {
  collector {
    id = "/broker/1"
  }

  json {
    url = "https://api.circonus.com/account/current"

    http_headers = {
      "Accept"                = "application/json"
      "X-Circonus-App-Name"   = "TerraformCheck"
      "X-Circonus-Auth-Token" = "${var.api_token}"
    }
  }

  metric {
    name = "${circonus_metric.used.name}"
    type = "${circonus_metric.used.type}"
  }
}

निम्नलिखित कमांड के साथ circonus_check संसाधन आयात करना संभव है:

$ terraform import circonus_check.usage ID

जहाँ ID चेक बंडल का _cid या Circonus ID है (जैसे /check_bundle/12345 ) और circonus_check.usage उस संसाधन का नाम है जिसका राज्य कमांड के परिणामस्वरूप आबाद होगा।