{"id":18859476,"url":"https://github.com/mattermost-community/mattermost-plugin-nagios","last_synced_at":"2025-10-28T04:17:00.761Z","repository":{"id":40655426,"uuid":"296624085","full_name":"mattermost-community/mattermost-plugin-nagios","owner":"mattermost-community","description":"Mattermost plugin to interact with Nagios Core ","archived":false,"fork":false,"pushed_at":"2024-04-18T11:26:57.000Z","size":850,"stargazers_count":3,"open_issues_count":2,"forks_count":11,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-04-14T12:14:32.501Z","etag":null,"topics":["hacktoberfest","mattermost","mattermost-plugin","nagios"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mattermost-community.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2020-09-18T13:08:33.000Z","updated_at":"2024-05-21T07:37:41.000Z","dependencies_parsed_at":"2024-03-17T06:05:48.357Z","dependency_job_id":"bbed20ad-d21e-4136-8615-01cf746c2fee","html_url":"https://github.com/mattermost-community/mattermost-plugin-nagios","commit_stats":{"total_commits":74,"total_committers":8,"mean_commits":9.25,"dds":"0.22972972972972971","last_synced_commit":"0daeb5309754aefb0fbd04d294e22ad5a2087e79"},"previous_names":["ulumuri/mattermost-plugin-nagios","mattermost-community/mattermost-plugin-nagios","mattermost/mattermost-plugin-nagios"],"tags_count":4,"template":false,"template_full_name":"mattermost/mattermost-plugin-starter-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost-community%2Fmattermost-plugin-nagios","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost-community%2Fmattermost-plugin-nagios/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost-community%2Fmattermost-plugin-nagios/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost-community%2Fmattermost-plugin-nagios/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mattermost-community","download_url":"https://codeload.github.com/mattermost-community/mattermost-plugin-nagios/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248877960,"owners_count":21176244,"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":["hacktoberfest","mattermost","mattermost-plugin","nagios"],"created_at":"2024-11-08T04:17:59.087Z","updated_at":"2025-10-28T04:17:00.666Z","avatar_url":"https://github.com/mattermost-community.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mattermost Nagios Plugin\n\n[![Build Status](https://img.shields.io/circleci/project/github/mattermost/mattermost-plugin-nagios/master)](https://circleci.com/gh/mattermost/mattermost-plugin-nagios)\n[![Code Coverage](https://img.shields.io/codecov/c/github/mattermost/mattermost-plugin-nagios/master)](https://codecov.io/gh/mattermost/mattermost-plugin-nagios)\n[![Release](https://img.shields.io/github/v/release/mattermost/mattermost-plugin-nagios)](https://github.com/mattermost/mattermost-plugin-nagios/releases/latest)\n[![HW](https://img.shields.io/github/issues/mattermost/mattermost-plugin-nagios/Up%20For%20Grabs?color=dark%20green\u0026label=Help%20Wanted)](https://github.com/mattermost/mattermost-plugin-nagios/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22Up+For+Grabs%22+label%3A%22Help+Wanted%22)\n\n**Help Wanted Tickets**\n\nVisit https://github.com/mattermost/mattermost-plugin-nagios/issues.\n\n# Contents\n\n- [Overview](#overview)\n- [Features](#features)\n- [Admin Guide](docs/admin-guide.md)\n- [End User Guide](#end-user-guide)\n- [Contribute](#contribute)\n- [License](#license)\n- [Security Vulnerability Disclosure](#security-vulnerability-disclosure)\n- [Get Help](#get-help)\n\n## Overview\n\nA Mattermost Plugin for Nagios to get logs, alerts, and notifications in Mattermost. Supports Nagios Core \u003e= 4.4.x.\n\n**Maintainers**: [@amwolff](https://github.com/amwolff) \u0026 [@DanielSz50](https://github.com/DanielSz50)\n\n## Features\n\nThis plugin allows you to:\n\n- Get logs from specific systems without leaving Mattermost.\n- Get alerts and notifications resembling the `showlog.cgi` UI instantly delivered.\n- Receive system monitoring reports on a subscribed channel.\n- Be frequently informed which hosts and services have an abnormal state.\n- Receive notifications about changes to the configuration on a subscribed channel.\n- Receive a diff between the old and the new version anytime a change has been made to Nagios configuration.\n\nThis README provides guidance on installation, configuration, and usage.\n\n## [Admin Guide](docs/admin-guide.md)\n\n## End User Guide\n\n### Get Started\n\n### Use the Plugin\n\n### Slash Commands Overview\n\n- `nagios`\n    - `get-logs \u003calerts|notifications\u003e`\n        - `[host|service \u003chost name|service description\u003e]`\n    - `set-logs-limit \u003ccount\u003e`\n    - `set-logs-start-time \u003cseconds\u003e`\n    - `subscribe \u003creport|configuration-changes\u003e`\n    - `unsubscribe \u003creport|configuration-changes\u003e`\n    - `set-report-frequency \u003cminutes\u003e`\n\n### Slash commands\n\n#### nagios\n\n`nagios`\n\nThis is the root command.\n\n##### get-logs\n\n`get-logs \u003calerts|notifications\u003e [\u003chost|service\u003e \u003chost name|service description\u003e]`\n\nThis action allows you to get alerts or notifications.\n\nExample: `/nagios get-logs alerts`\n\n###### host\n\n`get-logs \u003calerts|notifications\u003e host \u003chost name\u003e`\n\nThis optional parameter allows you to get alerts or notifications from a specific host.\n\nExample: `/nagios get-logs alerts host bvmhost-p09-02.iad2.fedoraproject.org`\n\n###### service\n\n`get-logs \u003calerts|notifications\u003e service \u003cservice description\u003e`\n\nThis optional parameter allows you to get alerts or notifications from a specific service.\n\nExample: `/nagios get-logs alerts service Swap-Is-Low`\n\n##### set-logs-limit\n\n`set-logs-limit \u003ccount\u003e`\n\nThis action allows you to limit the number of logs `get-logs` fetches.\n\nExample: `/nagios set-logs-limit 10`\n\n##### set-logs-start-time\n\n`set-logs-start-time \u003cseconds\u003e`\n\nThis action allows you to specify the age of the oldest log `get-logs` fetches.\n\nExample: `/nagios set-logs-start-time 3600`\n\n##### subscribe\n\n`subscribe \u003creport|configuration-changes\u003e`\n\nThis action allows you to subscribe to system monitoring reports or configuration changes on the current channel.\n\nExample: `/nagios subscribe report`\n\n##### unsubscribe\n\n`unsubscribe \u003creport|configuration-changes\u003e`\n\nThis action allows you to unsubscribe from system monitoring reports or configuration changes on the current channel.\n\nExample: `/nagios unsubscribe configuration-changes`\n\n##### set-report-frequency\n\n`set-report-frequency \u003cminutes\u003e`\n\nThis action allows you to set the frequency of system monitoring reports.\n\nExample: `/nagios set-report-frequency 60`\n\n### FAQ\n\n## Contribute\n\n### Development\n\nThis repository uses the [mattermost-plugin-starter-template](https://github.com/mattermost/mattermost-plugin-starter-template). Therefore, developing this plugin is roughly the same as it is with every plugin using the template. All the necessary steps to develop are in the template's repository.\n\nIf you are a Nagios admin/user and think there is something this plugin lacks or something that it does could be done another way, let us know! We are trying to develop this plugin based on users' needs. If there is a certain feature you or your team needs, open up an issue, and explain your needs. We will be happy to help.\n\nThis plugin only contains a server portion. Read our documentation about the [Developer Workflow](https://developers.mattermost.com/extend/plugins/developer-workflow/) and [Developer Setup](https://developers.mattermost.com/extend/plugins/developer-setup/) for more information about developing and extending plugins.\n\n### Running a Nagios server with Docker\n\nThere is a [docker-compose.yml](https://github.com/mattermost/mattermost-plugin-naguis/blob/master/dev/docker-compose.yml) in the `dev` folder of the repository, configured to run a Nagios server for development. You can run `make nagios` in the root of the repository to spin up the Nagios server. The Nagios web application will be served at http://localhost:8080.\n\nYou can login with these credentials:\n\n- Username: `nagiosadmin`\n- Password: `nagios`\n\n### Develop the watcher\n\nTo build the watcher, you can use the following command:\n\n```sh\nenv GOOS=linux GOARCH=amd64 go build -o dist/watcherX.Y.Z.linux-amd64 -a -v cmd/watcher/main.go\n```\n\nOf course, you can build the watcher for other operating systems and architectures too.\n\n### Deploy with Local Mode\n\nIf your Mattermost server is running locally, you can enable [local mode](https://docs.mattermost.com/administration/mmctl-cli-tool.html#local-mode) to streamline deploying your plugin. After configuring it, just run:\n\n```sh\nmake deploy\n```\n### Deploy with credentials\n\nAlternatively, you can authenticate with the server's API with a [personal access token](https://docs.mattermost.com/developer/personal-access-tokens.html):\n\n```sh\nexport MM_SERVICESETTINGS_SITEURL=http://localhost:8065\nexport MM_ADMIN_TOKEN=j44acwd8obn78cdcx7koid4jkr\nmake deploy\n```\n\nSee the Development guide section for information about how to contribute to this plugin.\n\n### I saw a bug, I have a feature request or a suggestion\n\nPlease file a [GitHub issue](https://github.com/mattermost/mattermost-plugin-nagios/issues), it will be very useful!\n\nPull Requests are welcome! You can contact us on the [Mattermost Community ~Plugin: Nagios channel](https://community.mattermost.com/core/channels/plugin-nagios).\n\nTo avoid having to manually install your plugin, build and deploy your plugin using one of the following options.\n\n### Share Feedback\n\nFeel free to create a [GitHub Issue](https://github.com/mattermost/mattermost-plugin-nagios/issues) or join the [Nagios Plugin channel](https://community.mattermost.com/core/channels/plugin-nagios) on the Mattermost Community server to discuss.\n\n## License\n\n## Security vulnerability disclosure\n\nPlease report any security vulnerability to [https://mattermost.com/security-vulnerability-report/](https://mattermost.com/security-vulnerability-report/).\n\n## Get Help\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattermost-community%2Fmattermost-plugin-nagios","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattermost-community%2Fmattermost-plugin-nagios","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattermost-community%2Fmattermost-plugin-nagios/lists"}