Co-authored-by: mchammer01 <42146119+mchammer01@users.noreply.github.com> Co-authored-by: docs-bot <77750099+docs-bot@users.noreply.github.com> Co-authored-by: Sophie <29382425+sophietheking@users.noreply.github.com> Co-authored-by: alejndr0 <alejndr0@github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Felicity Chapman <felicitymay@github.com>
3.8 KiB
title, intro, redirect_from, versions, type, topics, shortTitle
| title | intro | redirect_from | versions | type | topics | shortTitle | |||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Setting up external monitoring with collectd | Configure external monitoring systems to collect and analyze collectd metrics from your {% data variables.product.prodname_ghe_server %} instance. |
|
|
how_to |
|
External monitoring with collectd |
{% data reusables.enterprise.collectd-metrics-future %}
Set up an external collectd server
If you haven't already set up an external collectd server, you will need to do so before enabling collectd forwarding on {% data variables.location.product_location %}. Your collectd server must be running collectd version 5.x or higher.
- Log into your
collectdserver. - Create or edit the
collectdconfiguration file to load the network plugin and populate the server and port directives with the proper values. On most distributions, this is located at/etc/collectd/collectd.conf
An example collectd.conf to run a collectd server:
LoadPlugin network
...
...
<Plugin network>
Listen "0.0.0.0" "25826"
</Plugin>
Enabling collectd forwarding on {% data variables.product.prodname_enterprise %}
By default, collectd forwarding is disabled on {% data variables.product.prodname_enterprise %}. Follow the steps below to enable and configure collectd forwarding:
{% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %}
- Below the log forwarding settings, select Enable collectd forwarding.
- In the Server address field, type the address of the
collectdserver to which you'd like to forward {% data variables.product.prodname_enterprise %} appliance statistics. - In the Port field, type the port used to connect to the
collectdserver. (Defaults to 25826) - In the Cryptographic setup dropdown menu, select the security level of communications with the
collectdserver. (None, signed packets, or encrypted packets.) {% data reusables.enterprise_management_console.save-settings %}
Troubleshooting
Central collectd server receives no data
{% data variables.product.prodname_enterprise %} ships with collectd version 5.x. collectd 5.x is not backwards compatible with the 4.x release series. Your central collectd server needs to be at least version 5.x to accept data sent from {% data variables.location.product_location %}.
For help with further questions or issues, visit {% data variables.contact.contact_ent_support %}.