Graylog: How to create an input on Graylog

This documentation is part of the Configure inputs guide. You can view the complete guide here: How to configure Graylog inputs.

👋 Welcome to the Stackhero documentation!

Stackhero offers a ready-to-use Graylog cloud solution that provides a host of benefits, including:

• Unlimited and dedicated SMTP email server included.
• Effortless updates with just a click.
• Customisable domain name secured with HTTPS (for example, https://logs.your-company.com).
• Optimal performance and robust security powered by a private and dedicated VM.

Save time and simplify your life: it only takes 5 minutes to try Stackhero's Graylog cloud hosting solution!

To configure your Graylog input, you must first create it from the Graylog web interface. Then, declare the input on the Stackhero dashboard and open the necessary firewall port(s) to allow traffic to reach your instance.

1. Declare the input on the Graylog web interface

1. Log in to the Graylog web interface and go to System, then Inputs.

2. In the Select input dropdown menu, choose an input based on the type of data you will receive and click Launch new input.

   Selecting an input on Graylog web UI

3. In the window that opens, tick Global and assign a title (for example, "GELF UDP" if you do not have a more specific title). Do not modify any other settings unless you are certain of what you are doing.

If you wish to use TLS encryption (SSL/HTTPS), DO NOT select TLS in the Graylog web interface. TLS encryption is managed directly by your reverse proxy via the Stackhero dashboard.

Example of a GELF UDP input in Graylog

1. Note the port of your input, as you will need to specify it later on the Stackhero dashboard. Then click Save.

2. Declare the input on Stackhero

After creating the input on the Graylog web interface, you need to declare it on the Stackhero dashboard.

1. Go to your Stackhero dashboard and select your Graylog instance.
2. Click on the Configure button.
3. In the Input ports list, check if the port for your new input is already declared. If not, add it.
4. Check the protocol type (UDP or TCP). If you are using TCP, you can enable TLS encryption (SSL/HTTPS) by ticking the corresponding option (remember that you should not enable TLS on the Graylog web interface!).
5. Once these steps are complete, validate your new configuration.

Example of a GELF UDP input configuration on Stackhero

3. Allow traffic through the firewall

Finally, after declaring your input on the Stackhero dashboard, you need to allow traffic through your firewall.

1. Go to the Stackhero dashboard, select your Graylog service, and click on Firewall.
2. Check that there is a rule accepting traffic from your IP (or use 0.0.0.0/0 to allow all IPs).
3. If no such rule exists, create one by clicking the Add a rule button.
4. Select the IP you wish to allow (set it to 0.0.0.0/0 for all IPs), and specify the ports that will receive data from this IP.
5. Choose the Accept action.

Save the rule and validate the configuration by clicking the Validate button.

Example of a firewall configuration

Your input is now fully configured and ready to use!