{"id":19585902,"url":"https://github.com/cacti/plugin_servcheck","last_synced_at":"2025-04-27T11:35:04.140Z","repository":{"id":214538665,"uuid":"735198521","full_name":"Cacti/plugin_servcheck","owner":"Cacti","description":null,"archived":false,"fork":false,"pushed_at":"2024-11-02T16:54:23.000Z","size":1513,"stargazers_count":2,"open_issues_count":2,"forks_count":3,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-11-02T17:28:37.372Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cacti.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-24T02:49:22.000Z","updated_at":"2024-11-02T16:51:57.000Z","dependencies_parsed_at":"2024-04-20T14:44:22.733Z","dependency_job_id":"a2400f05-5a2c-4010-8f11-1e48a456a69c","html_url":"https://github.com/Cacti/plugin_servcheck","commit_stats":null,"previous_names":["cacti/plugin_servcheck"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cacti%2Fplugin_servcheck","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cacti%2Fplugin_servcheck/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cacti%2Fplugin_servcheck/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cacti%2Fplugin_servcheck/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cacti","download_url":"https://codeload.github.com/Cacti/plugin_servcheck/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224069493,"owners_count":17250456,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-11T07:57:44.807Z","updated_at":"2025-04-27T11:35:04.133Z","avatar_url":"https://github.com/Cacti.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# servcheck\n\n## Cacti Service checker Plugin\n\nThis is Cacti's Services monitoring plugin. Based on Webseer plugin.\nThis plugin allows you to add service monitoring to Cacti. \nYou simply add service check, allow service specific test (like certificate test)\nand you can add the expected response. Servcheck periodically run test \nand notify if a service check fails. The plugin records statistics\nabout the connection, it's response, and can alert when the\nstatus changes.\n\nThis plugin, like many others, integrates with Cacti's Maintenance or 'maint'\nplugin so you can setup maintenance schedules so that known times when a service\nis going to be down can be configured so that escallation does not needlessly\ntake place during maintenance periods.\n\n## Installation\n\nTo install the servcheck plugin, simply copy the plugin_servcheck directory to\nCacti's plugins directory and rename it to simply 'servcheck'. Once you have done\nthis, goto Cacti's Plugin Management page, Install and Enable the servcheck. Once\nthis is complete, you can grant users permission to create service checks for\nvarious services.\n\nGo to Management -\u003e Service Checker\n\nYou need install libcurl library. For more information about Curl/libcurl \nvisit https://www.php.net/manual/en/book.curl.php\n\n## Tests and results\nTest can return more results. First result is from curl. There is a lot of  information \nabout curl connection. Second result is returned data on which you can perform searches.\n\nEach test has icon for display last result. You can use it for creation  of search string.\n\nEach tests return specific data:\nHTTP and HTTPS - returns webpage\nSMTP, SMTPS - only connect to SMTP server and displays EHLO/HELO\nPOP3, POP3S - try to login and display first unread message\nIMAP, IMAPS - try to login and display unread messages in inbox\nDNS - try to resolve A record and return answer\nLDAP and LDAPS - do searching in LDAP\nFTP, FTPS - try to login and return directory listing\nTFTP - try to download specific file\nSCP - try to login and download specific file\nSMB, SMBS - try to login and download specific file\nMQTT - try to subscribe topic or wait for any message and print result\n\n## Important\nRecommendation for tests with download -  please download only small not binary files.\n\nDefault Libcurl build doesn't compile all services. You have to compile again for SMB, LDAP, ...\n\nFor POP3 and IMAP tests is better insert correct username and password. Without credentials, \ncurl will return incorrect result.\n\nSCP is in insecure mode - doesn't check SSH server key!\n\nMQTT is only plaintext. You can specify username and password. MQTT test waits for the first messase from a given topic\nor for any message if the topic has not been specified.\n\nDo not test other servers without permission!\n\nServcheck uses a file of certificates from common root CAs to check certificates. This will work\nfor certificates issued by common CAs. If you are using a custom CA\n(for example, in a Microsoft AD environment), the test for that certificate will fail\nbecause servcheck does not know your CA. You must upload the entire chain\n(CA certificate and intermediate certificates). You then associate these with the test\nwhere the certificate issued by your CA\n\n## Bugs and Feature Enhancements\n\nBug and feature enhancements for the servcheck plugin are handled in GitHub. If\nyou find a first search the Cacti forums for a solution before creating an issue\nin GitHub - https://github.com/Cacti/plugin_servcheck\n\nYou can find more information on our forum - http://forums.cacti.net/viewtopic.php?t=62934\n\n-----------------------------------------------\nCopyright (c) 2004-2024 - The Cacti Group, Inc.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcacti%2Fplugin_servcheck","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcacti%2Fplugin_servcheck","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcacti%2Fplugin_servcheck/lists"}