icinga2/doc/01-about.md

# About Icinga 2 <a id="about-icinga2"></a>

## What is Icinga 2?  <a id="what-is-icinga2"></a>

[Icinga](https://icinga.com/products/) is a monitoring system which checks
the availability of your network resources, notifies users of outages, and generates
performance data for reporting.

Scalable and extensible, Icinga can monitor large, complex environments across
multiple locations. This includes your data center as well as your private, public, or hybrid clouds.

Icinga 2 is the monitoring server and requires [Icinga Web 2](https://icinga.com/products/)
on top in your Icinga Stack. The [configuration](https://icinga.com/products/configuration/)
can be easily managed with either the [Icinga Director](https://icinga.com/docs/director/latest/),
config management tools or plain text within the [Icinga DSL](04-configuration.md#configuration).


![Icinga 2 Distributed Master and Satellites with Agents](images/distributed-monitoring/icinga2_distributed_monitoring_scenarios_master_satellites_agents.png)

## Start with Icinga <a id="start-icinga"></a>

* [Installation](02-installation.md#installation)
* [Monitoring Basics](03-monitoring-basics.md#monitoring-basics)
* [Configuration](04-configuration.md#configuration)
* [Distributed Monitoring](06-distributed-monitoring.md#distributed-monitoring)
* [Addons, Integrations and Features](13-addons.md#addons)
* [Troubleshooting](15-troubleshooting.md#troubleshooting)
* [Upgrading](16-upgrading-icinga-2.md#upgrading-icinga-2)

Once Icinga Server and Web are running in your distributed environment,
make sure to check out the many [Icinga modules](https://icinga.com/docs/)
for even better monitoring.

## What's New <a id="whats-new"></a>

You can follow the development and release milestones on [GitHub](https://github.com/icinga/icinga2/issues).
Please follow our release announcements on [icinga.com](https://icinga.com/blog/) too.

## Support <a id="support"></a>

Check the project website at [icinga.com](https://icinga.com) for status updates. Join the
[community channels](https://icinga.com/community/) for questions
or get in touch for [professional support](https://icinga.com/subscription/).

## Contribute  <a id="contribute"></a>

There are many ways to contribute to Icinga -- whether it be sending patches,
testing, reporting bugs or reviewing and updating the documentation. Every
contribution is appreciated!

Please continue reading in the [Contributing chapter](https://github.com/Icinga/icinga2/blob/master/CONTRIBUTING.md).

### Security Issues <a id="security"></a>

For reporting security issues please visit [this page](https://icinga.com/contact/security/).

### Icinga 2 Development <a id="development-info"></a>

The Git repository is located on [GitHub](https://github.com/Icinga/icinga2).

Icinga 2 is written in C++ and can be built on Linux/Unix and Windows.
Read more about development builds in the [development chapter](21-development.md#development).


## License <a id="license"></a>

Icinga 2 and the Icinga 2 documentation are licensed under the terms of the GNU
General Public License Version 2. You will find a copy of this license in the
LICENSE file included in the source package.
Update docs for better compatibility with mkdocs * Rename files to allow easy ordering * Update links inside markdown according to new file names * Move HTML links (<a>...</a>) to the end of the header lines * This is necessary to allow mkdocs to parse headers correctly and display them in the TOC * Following sed command was used: sed -i .bu 's/\(<a.a>\) \(.\)/\2 \1/g' $filename 2017-07-12 14:46:12 -04:00			`# About Icinga 2 <a id="about-icinga2"></a>`
Add documentation files. 2013-09-26 02:59:29 -04:00
Update docs for better compatibility with mkdocs * Rename files to allow easy ordering * Update links inside markdown according to new file names * Move HTML links (<a>...</a>) to the end of the header lines * This is necessary to allow mkdocs to parse headers correctly and display them in the TOC * Following sed command was used: sed -i .bu 's/\(<a.a>\) \(.\)/\2 \1/g' $filename 2017-07-12 14:46:12 -04:00			`## What is Icinga 2? <a id="what-is-icinga2"></a>`
Add documentation files. 2013-09-26 02:59:29 -04:00
Docs: Update URLs and content in About chapter 2019-09-17 02:51:32 -04:00			`[Icinga](https://icinga.com/products/) is a monitoring system which checks`
Docs: Update our About chapter This is visible first when opening icinga.com/docs/icinga2/latest refs #6830 2019-07-20 09:34:45 -04:00			`the availability of your network resources, notifies users of outages, and generates`
			`performance data for reporting.`
Update documentation. Refs #5870 2014-03-30 05:52:39 -04:00
Docs: Update URLs and content in About chapter 2019-09-17 02:51:32 -04:00			`Scalable and extensible, Icinga can monitor large, complex environments across`
Add documentation about Icinga 2 use cases (#9065) Added examples about different kind of use cases that will help users get a better picture of Icinga. 2021-11-15 11:51:37 -05:00			`multiple locations. This includes your data center as well as your private, public, or hybrid clouds.`
Update documentation. 2013-09-26 08:01:29 -04:00
Docs: Update URLs and content in About chapter 2019-09-17 02:51:32 -04:00			`Icinga 2 is the monitoring server and requires [Icinga Web 2](https://icinga.com/products/)`
			`on top in your Icinga Stack. The [configuration](https://icinga.com/products/configuration/)`
			`can be easily managed with either the [Icinga Director](https://icinga.com/docs/director/latest/),`
			`config management tools or plain text within the [Icinga DSL](04-configuration.md#configuration).`
Add documentation files. 2013-09-26 02:59:29 -04:00
Update documentation. 2013-09-26 08:01:29 -04:00
Docs: Update our About chapter This is visible first when opening icinga.com/docs/icinga2/latest refs #6830 2019-07-20 09:34:45 -04:00			`![Icinga 2 Distributed Master and Satellites with Agents](images/distributed-monitoring/icinga2_distributed_monitoring_scenarios_master_satellites_agents.png)`

			`## Start with Icinga <a id="start-icinga"></a>`

			`* [Installation](02-installation.md#installation)`
			`* [Monitoring Basics](03-monitoring-basics.md#monitoring-basics)`
			`* [Configuration](04-configuration.md#configuration)`
			`* [Distributed Monitoring](06-distributed-monitoring.md#distributed-monitoring)`
			`* [Addons, Integrations and Features](13-addons.md#addons)`
			`* [Troubleshooting](15-troubleshooting.md#troubleshooting)`
			`* [Upgrading](16-upgrading-icinga-2.md#upgrading-icinga-2)`

Docs: Update URLs and content in About chapter 2019-09-17 02:51:32 -04:00			`Once Icinga Server and Web are running in your distributed environment,`
Docs: Update our About chapter This is visible first when opening icinga.com/docs/icinga2/latest refs #6830 2019-07-20 09:34:45 -04:00			`make sure to check out the many [Icinga modules](https://icinga.com/docs/)`
			`for even better monitoring.`

			`## What's New <a id="whats-new"></a>`

			`You can follow the development and release milestones on [GitHub](https://github.com/icinga/icinga2/issues).`
			`Please follow our release announcements on [icinga.com](https://icinga.com/blog/) too.`

			`## Support <a id="support"></a>`
Add documentation files. 2013-09-26 02:59:29 -04:00
icinga.com: Update everything else 2018-10-18 03:50:53 -04:00			`Check the project website at [icinga.com](https://icinga.com) for status updates. Join the`
icinga.com: Update docs for /community/get-involved -> /community 2018-10-18 03:32:14 -04:00			`[community channels](https://icinga.com/community/) for questions`
Docs: Update our About chapter This is visible first when opening icinga.com/docs/icinga2/latest refs #6830 2019-07-20 09:34:45 -04:00			`or get in touch for [professional support](https://icinga.com/subscription/).`
Update documentation. 2013-09-26 08:01:29 -04:00
Update docs for better compatibility with mkdocs * Rename files to allow easy ordering * Update links inside markdown according to new file names * Move HTML links (<a>...</a>) to the end of the header lines * This is necessary to allow mkdocs to parse headers correctly and display them in the TOC * Following sed command was used: sed -i .bu 's/\(<a.a>\) \(.\)/\2 \1/g' $filename 2017-07-12 14:46:12 -04:00			`## Contribute <a id="contribute"></a>`
Documentation: Add 'contribute' section. 2014-03-20 16:24:39 -04:00
Changes hyphens (-) to en dashes (typography) refs #11599 2016-04-22 10:05:09 -04:00			`There are many ways to contribute to Icinga -- whether it be sending patches,`
Fixed grammer and spelling mistakes 2017-10-30 12:02:42 -04:00			`testing, reporting bugs or reviewing and updating the documentation. Every`
Update documentation 2015-02-06 09:08:51 -05:00			`contribution is appreciated!`
Documentation: Add 'contribute' section. 2014-03-20 16:24:39 -04:00
Update documentation for new contributing file refs #5156 2017-04-18 12:06:52 -04:00			`Please continue reading in the [Contributing chapter](https://github.com/Icinga/icinga2/blob/master/CONTRIBUTING.md).`
Documentation: Add wiki howto url for help updating the docs 2015-03-07 11:12:45 -05:00
Docs: Add security issue URL to About chapter 2019-06-28 11:49:26 -04:00			`### Security Issues <a id="security"></a>`

			`For reporting security issues please visit [this page](https://icinga.com/contact/security/).`

Update docs for better compatibility with mkdocs * Rename files to allow easy ordering * Update links inside markdown according to new file names * Move HTML links (<a>...</a>) to the end of the header lines * This is necessary to allow mkdocs to parse headers correctly and display them in the TOC * Following sed command was used: sed -i .bu 's/\(<a.a>\) \(.\)/\2 \1/g' $filename 2017-07-12 14:46:12 -04:00			`### Icinga 2 Development <a id="development-info"></a>`
Add troubleshooting chapter, fix addon chapter. Fixes #5611 Fixes #6275 2014-05-22 19:01:06 -04:00
Update README.md and correct project URLs fixes #13491 2016-12-08 11:38:41 -05:00			`The Git repository is located on [GitHub](https://github.com/Icinga/icinga2).`
Add troubleshooting chapter, fix addon chapter. Fixes #5611 Fixes #6275 2014-05-22 19:01:06 -04:00
Update README.md and correct project URLs fixes #13491 2016-12-08 11:38:41 -05:00			`Icinga 2 is written in C++ and can be built on Linux/Unix and Windows.`
Improve development docs for macOS & Windows for 2.11 - macOS doesn't require sudo anymore - Windows builds must use Boost 1.66+ - Fix link in About section - Add recommended books: Boost application programming 2019-04-02 09:30:35 -04:00			`Read more about development builds in the [development chapter](21-development.md#development).`
Documentation: Add a note for the vagrant demo vm to 'about' . Fixes #6248 2014-05-20 09:12:55 -04:00
Update ChangeLog. Refs #5254 2013-12-03 03:47:07 -05:00
Docs: Update our About chapter This is visible first when opening icinga.com/docs/icinga2/latest refs #6830 2019-07-20 09:34:45 -04:00			`## License <a id="license"></a>`

			`Icinga 2 and the Icinga 2 documentation are licensed under the terms of the GNU`
			`General Public License Version 2. You will find a copy of this license in the`
			`LICENSE file included in the source package.`