﻿---
title: Configure SSL/TLS for the Logstash output
description: To send data from Elastic Agent to Logstash securely, you need to configure Transport Layer Security (TLS). Using TLS ensures that your Elastic Agents...
url: https://www.elastic.co/elastic/docs-builder/docs/2830/reference/fleet/secure-logstash-connections
products:
  - Elastic Agent
  - Fleet
applies_to:
  - Elastic Cloud Serverless: Generally available
  - Elastic Stack: Generally available
---

# Configure SSL/TLS for the Logstash output
To send data from Elastic Agent to Logstash securely, you need to configure Transport Layer Security (TLS). Using TLS ensures that your Elastic Agents send encrypted data to trusted Logstash servers, and that your Logstash servers receive data from trusted Elastic Agent clients.

## Prerequisites

- Make sure your [subscription level](https://www.elastic.co/subscriptions) supports output to Logstash.
- On Windows, add port 8220 for Fleet Server and 5044 for Logstash to the inbound port rules in Windows Advanced Firewall.
- If you are connecting to a self-managed Elasticsearch cluster, you need the CA certificate that was used to sign the certificates for the HTTP layer of Elasticsearch cluster. For more information, refer to the [Elasticsearch security docs](https://www.elastic.co/elastic/docs-builder/docs/2830/deploy-manage/deploy/self-managed/installing-elasticsearch).


## Generate custom certificates and private keys

You can use whatever process you typically use to generate PEM-formatted certificates. The examples shown here use the `certutil` tool provided by Elasticsearch.
<tip>
  - The `certutil` tool is not available on Elastic Cloud, but you can still use it to generate certificates for Elastic Agent to Logstash connections. [Download an Elasticsearch package](https://www.elastic.co/downloads/elasticsearch), extract it to a local directory, and run the `elasticsearch-certutil` command. There's no need to start Elasticsearch!
  - If you choose not to use [`certutil`](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/2830/reference/elasticsearch/command-line-tools/certutil), the certificates that you obtain must allow for both `clientAuth` and `serverAuth` if the extended key usage extension is present.
</tip>

1. Generate a certificate authority (CA). Skip this step if you want to use an existing CA.
   ```shell
   ./bin/elasticsearch-certutil ca --pem
   ```
   This command creates a zip file that contains the CA certificate and key you’ll use to sign the certificates. Extract the zip file:
   ![Screen capture of a folder called ca that contains two files: ca.crt and ca.key](https://www.elastic.co/elastic/docs-builder/docs/2830/reference/fleet/images/ca-certs.png)
2. Generate a client SSL certificate signed by your CA. For example:
   ```shell
   ./bin/elasticsearch-certutil cert \
     --name client \
     --ca-cert /path/to/ca/ca.crt \
     --ca-key /path/to/ca/ca.key \
     --pem
   ```
   Extract the zip file:
   ![Screen capture of a folder called client that contains two files: client.crt and client.key](https://www.elastic.co/elastic/docs-builder/docs/2830/reference/fleet/images/client-certs.png)
3. Generate a Logstash SSL certificate signed by your CA. For example:
   ```shell
   ./bin/elasticsearch-certutil cert \
     --name logstash \
     --ca-cert /path/to/ca/ca.crt \
     --ca-key /path/to/ca/ca.key \
     --dns your.host.name.here \
     --ip 192.0.2.1 \
     --pem
   ```
   Extract the zip file:
   ![Screen capture of a folder called logstash that contains two files: logstash.crt and logstash.key](https://www.elastic.co/elastic/docs-builder/docs/2830/reference/fleet/images/logstash-certs.png)
4. Convert the Logstash key to pkcs8. For example, on Linux run:
   ```shell
   openssl pkcs8 -inform PEM -in logstash.key -topk8 -nocrypt -outform PEM -out logstash.pkcs8.key
   ```

Store these files in a secure location.

## Configure the Logstash pipeline

<tip>
  If you’ve already created the Logstash `elastic-agent-pipeline.conf` pipeline and added it to `pipelines.yml`, skip to the example configurations and modify your pipeline configuration as needed.
</tip>

In your Logstash configuration directory, open the `pipelines.yml` file and add the following configuration. Replace the path to your file.
```yaml
- pipeline.id: elastic-agent-pipeline
  path.config: "/etc/path/to/elastic-agent-pipeline.conf"
```

In the `elastic-agent-pipeline.conf` file, add the pipeline configuration. The configuration needed for Elastic Cloud Hosted is different from self-managed Elasticsearch clusters. If you copied the configuration shown in Fleet, adjust it as needed.

### Elasticsearch Serverless example

```text
input {
  elastic_agent {
    port => 5044
    ssl_enabled => true
    ssl_certificate_authorities => ["/path/to/ca.crt"]
    ssl_certificate => "/path/to/logstash.crt"
    ssl_key => "/path/to/logstash.pkcs8.key"
    ssl_client_authentication => "required"
  }
}

output {
  elasticsearch {
    hosts => "ELASTICSEARCH_ENDPOINT_URL" 
    api_key => "xxxx:xxxx" 
    data_stream => true
  }
}
```


### Elastic Cloud Hosted example

```text
input {
  elastic_agent {
    port => 5044
    ssl_enabled => true
    ssl_certificate_authorities => ["/path/to/ca.crt"]
    ssl_certificate => "/path/to/logstash.crt"
    ssl_key => "/path/to/logstash.pkcs8.key"
    ssl_client_authentication => "required"
  }
}

output {
  elasticsearch {
    cloud_id => "xxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxx=" 
    api_key => "xxxx:xxxx" 
    data_stream => true
  }
}
```


### Self-managed Elasticsearch cluster example

```text
input {
  elastic_agent {
    port => 5044
    ssl_enabled => true
    ssl_certificate_authorities => ["/path/to/ca.crt"]
    ssl_certificate => "/path/to/logstash.crt"
    ssl_key => "/path/to/logstash.pkcs8.key"
    ssl_client_authentication => "required"
  }
}

output {
  elasticsearch {
    hosts => "https://xxxx:9200"
    api_key => "xxxx:xxxx"
    data_stream => true
    ssl_certificate_authorities => "/path/to/http_ca.crt" 
  }
}
```

To learn more about the Logstash configuration, refer to:
- [Elastic Agent input plugin](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/2830/lsr/plugins-inputs-elastic_agent)
- [Elasticsearch output plugin](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/2830/lsr/plugins-outputs-elasticsearch)
- [Secure your connection to Elasticsearch](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/2830/reference/logstash/secure-connection)

When you’re done configuring the pipeline, restart Logstash:
```shell
bin/logstash
```


## Add a Logstash output to Fleet

This section describes how to add a Logstash output and configure SSL settings in Fleet. If you’re running Elastic Agent standalone, refer to the [Logstash output](https://www.elastic.co/elastic/docs-builder/docs/2830/reference/fleet/logstash-output) configuration docs.
1. In Kibana, go to **Fleet > Settings**.
2. Under **Outputs**, click **Add output**. If you’ve been following the Logstash steps in Fleet, you might already be on this page.
3. Specify a name for the output.
4. For **Type**, select **Logstash**.
5. Under **Logstash hosts**, specify the host and port your agents will use to connect to Logstash. Use the format `host:port`.
6. In the **Server SSL certificate authorities** field, paste in the entire contents of the `ca.crt` file you [generated earlier](#generate-logstash-certs).
7. In the **Client SSL certificate** field, paste in the entire contents of the `client.crt` file you generated earlier.
8. In the **Client SSL certificate key** field, paste in the entire contents of the `client.key` file you generated earlier.

![Screen capture of a folder called `logstash` that contains two files: logstash.crt and logstash.key](https://www.elastic.co/elastic/docs-builder/docs/2830/reference/fleet/images/add-logstash-output.png)

When you’re done, save and apply the settings.

## Select the Logstash output in an agent policy

Logstash is now listening for events from Elastic Agent, but events are not streaming into Elasticsearch yet. You need to select the Logstash output in an agent policy. You can edit an existing policy or create a new one:
1. In Kibana, go to **Fleet > Agent policies** and either create a new agent policy or click an existing policy to edit it:
   - To change the output settings in a new policy, click **Create agent policy** and expand **Advanced options**.
- To change the output settings in an existing policy, click the policy to edit it, then click **Settings**.
2. Set **Output for integrations** and (optionally) **Output for agent monitoring** to use the Logstash output you created earlier. You might need to scroll down to see these options
   ![Screen capture showing the Logstash output policy selected in an agent policy](https://www.elastic.co/elastic/docs-builder/docs/2830/reference/fleet/images/agent-output-settings.png)
3. Save your changes.

Any Elastic Agents enrolled in the agent policy will begin sending data to Elasticsearch through Logstash. If you don't have any installed Elastic Agents enrolled in the agent policy, do that now.
There might be a slight delay while the Elastic Agents update to the new policy and connect to Logstash over a secure connection.

## Test the connection

To make sure Logstash is sending data, run the following command from the host where Logstash is running:
```shell
curl -XGET localhost:9600/_node/stats/events
```

The request should return stats on the number of events in and out. If these values are 0, check the Elastic Agent logs for problems.
When data is streaming to Elasticsearch, go to **Observability** and click **Metrics** to view metrics about your system.