Skip to main content
Version: 1.0

Graylog Getting Started

Graylog is on a mission to make Log Management and SIEM easier, faster, more affordable, and more effective.

If you have installed Websoft9 Graylog, the following steps is for your quick start

Preparation​

  1. Get the Internet IP of your Server on Cloud
  2. Check your Inbound of Security Group Rule of Cloud Console to ensure the TCP:80 is allowed
  3. Complete Five steps for Domain if you want to use Domain for Graylog
  4. Get default username and password of Graylog

Graylog Initialization​

Steps for you​

  1. Using local Chrome or Firefox to visit the URL http://DNS or http://Server's Internet IP, you can see the login page of Graylog. login Graylog websoft9

  2. Input the login account and enter to Graylog Console(Don't have password?)

  3. if you want to bind domain for Graylog, refer to here

More useful Graylog guide, please refer to Configuring Graylog

Having trouble?​

Below is for you to solve problem, and you can contact Websoft9 Support or refer to Troubleshoot + FAQ to get more.

Graylog QuickStart​

正在编写

Graylog Setup​

Configure SMTP​

  1. Get SMTP related parameters in the mailbox management console

  2. Refer to Official email setting by editing the email Graylog configuration file: /etc/graylog/server/server.conf

  3. Modify the items transport_email of Graylog configuration file

  4. Restart Graylog service

    sudo docker restart graylog

Reset Password​

Try to reset your password if you can't use email to reset it:

  1. Use SSH tool to login Server, then run the below commands

    new_password=admin123@graylog
    sha_password=$(echo -n $new_password | sha256sum | awk '{ print $1 }')
    sudo sed -i "s/8c6976e5b5410415bde908bd4dee15dfb167a9c873fc4bb8a81f6f2ab448a918/$sha_password/g" /data/wwwroot/graylog/.env

  2. You new password is admin123@graylog now after docker-compose recreate

    cd /data/wwwroot/graylog && sudo docker-compose up -d

You can set the new_password to any string if you want

Configure Graylog​

Every configuration option can be set via environment variables.. Simply prefix the parameter name with GRAYLOG_ and put it all in upper case.

For example, setting up the SMTP configuration for sending Graylog alert notifications via email, the docker-compose.yml would look like this:

version: '2'
  services:
    mongo:
      image: "mongo:4.2"
      # Other settings [...]
    elasticsearch:
      image: docker.elastic.co/elasticsearch/elasticsearch-oss:7.10.2
      # Other settings [...]
    graylog:
      image: graylog/graylog:4.2
      # Other settings [...]
      environment:
        GRAYLOG_TRANSPORT_EMAIL_ENABLED: "true"
        GRAYLOG_TRANSPORT_EMAIL_HOSTNAME: smtp
        GRAYLOG_TRANSPORT_EMAIL_PORT: 25
        GRAYLOG_TRANSPORT_EMAIL_USE_AUTH: "false"
        GRAYLOG_TRANSPORT_EMAIL_USE_TLS: "false"
        GRAYLOG_TRANSPORT_EMAIL_USE_SSL: "false"

Reference sheet​

The below items and General parameter sheet is maybe useful for you manage Graylog

Run docker ps command, view all Containers when Graylog is running:

CONTAINER ID   IMAGE                                                  COMMAND                  CREATED              STATUS                        PORTS                                                                                                                                                                                                                           NAMES
aba3f411351a   websoft9dev/mongocompass:v1.31                         "/dockerstartup/kasm…"   39 seconds ago       Up 37 seconds                 4901/tcp, 5901/tcp, 0.0.0.0:9091->6901/tcp, :::9091->6901/tcp                                                                                                                                                                   mongocompass
8285b315009a   graylog/graylog:4.3                                    "/usr/bin/tini -- wa…"   About a minute ago   Up About a minute (healthy)   0.0.0.0:1514->1514/tcp, 0.0.0.0:1514->1514/udp, :::1514->1514/tcp, :::1514->1514/udp, 0.0.0.0:12201->12201/tcp, 0.0.0.0:12201->12201/udp, :::12201->12201/tcp, :::12201->12201/udp, 0.0.0.0:9001->9000/tcp, :::9001->9000/tcp   graylog
7795d2333c74   docker.elastic.co/elasticsearch/elasticsearch:7.16.3   "/bin/tini -- /usr/l…"   About a minute ago   Up About a minute             9200/tcp, 9300/tcp                                                                                                                                                                                                              graylog-elasticsearch
04dc27b0962c   mongo:4.2                                              "docker-entrypoint.s…"   About a minute ago   Up About a minute             27017/tcp                                          "docker-entrypoint.s…"   8 minutes ago   Up 3 minutes             0.0.0.0:9091->1234/tcp, :::9091->1234/tcp                                                                                                                                                                                       adminmongo

Path​

Graylog installation directory::  /data/apps/graylog
Graylog data directory:  /data/apps/graylog/data/graylog/graylog_data
Graylog plugin directory:  /data/apps/graylog/data/graylog/graylog_plugin

Port​

No special port

Version​

# Graylog Version
docker images |grep graylog/graylog |awk '{print $2}'

Service​

sudo docker  start | stop | restart | status graylog
sudo docker  start | stop | restart | status graylog-mongo
sudo docker  start | stop | restart | status graylog-elasticsearch
sudo docker  start | stop | restart | status mongocompass

CLI​

API​

[Graylog API] (https://docs.graylog.org/v1/docs/rest-api) Using the REST API 2.0 specification, even the Graylog web interface specifically uses the Graylog REST API to interact with the Graylog cluster.

API access mode: https://IP/api/api-browser/global/index.html, without /global/index.html is inaccessible.