README.md

Send logs from Logstash on Cloud9 to OpenSearch

Follow the instructions below

1. Run the CloudFormation stack below. It will create the required resources required for this example

The resources created by the CloudFormation stack are documented in the architecture below

2. Open the Cloud9 environment and install Logstash. Complete all of the subsequent steps in the Cloud9 terminal

Download logstash

curl https://artifacts.opensearch.org/logstash/logstash-oss-with-opensearch-output-plugin-7.16.2-linux-x64.tar.gz -o logstash-oss-with-opensearch-output-plugin-7.16.2-linux-x64.tar.gz

Uncompress download

tar -zxvf logstash-oss-with-opensearch-output-plugin-7.16.2-linux-x64.tar.gz

3. Configure Logstash

Create configuration file

sudo vim logstash-config.conf

Copy / paste the following into the the logstash-config.conf file. Replace the path, hosts, user, password parts of the config

input {
    file {
        path => "<path_to_log_file>"
        start_position => "beginning"
    }
}
output {
    opensearch {
        hosts       => ["<opensearch_domain_endpoint>:443"]
        user        => "<opensearch_user_name>"
        password    => "<opensearch_password>"
        index       => "logstash-logs-%{+YYYY.MM.dd}"
    }
}

4. Run Logstash

/home/ec2-user/environment/logstash-7.16.2/bin/logstash -f /home/ec2-user/environment/logstash-config.conf

5. Add logs to the log file / folder specified by the path. If you need sample log data you can use the following

Note you made need to modify the premisions on the log file via. chmod 777 logstash-config.conf

{"timestamp":1661869220203, "CPU": 90, "Message": "High CPU"}
{"timestamp":1661869220203, "Memory": 90, "Message": "High Memory"}
{"timestamp":1661869220203, "Disk": 80, "Message": "High Disk"}
{"timestamp":1661869220203, "Network": 100, "Message": "High Network"}