Type to search.

Standalone Elastic Agent connectivity using a proxy server

Serverless

Elastic Cloud Serverless projects are autoscaled environments, fully managed by Elastic and available on Elastic Cloud.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

Serverless interfaces and procedures might differ from classic Elastic Stack deployments.

Stack

The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Proxy settings in the Elastic Agent policy override proxy settings specified by environment variables. This means you can specify proxy settings for Elastic Agent that are different from host or system-level environment settings.

The following proxy settings are valid in the agent policy:

Setting Description
proxy_url (string) URL of the proxy server. If set, the configured URL is used as a proxy for all connection attempts by the component. The value can be either a complete URL or a host[:port], in which case the http scheme is assumed. Ifa value is not specified through the configuration, then proxy environment variables are used. The URL accepts optional username and password settings for authenticating with the proxy. For example: http://<username>:<password>@<proxy host>/.
proxy_headers (string) Additional headers to send to the proxy during CONNECT requests. You can use this setting to pass keys/tokens required for authenticating with the proxy.
proxy_disable (boolean) If set to true, all proxy settings, including the HTTP_PROXY andHTTPS_PROXY environment variables, are ignored.

Set the proxy for communicating with Elasticsearch

For standalone agents, to set the proxy for communicating with Elasticsearch, specify proxy settings in the elastic-agent.yml file. For example:

YAML 
outputs:
  default:
    api_key: API-KEY
    hosts:
    - https://10.0.1.2:9200
    proxy_url: http://10.0.1.7:3128
    type: elasticsearch

For more information, refer to Configure standalone Elastic Agentss.