Separate Ingest Box

Other than having a separate domain to view the web UI and ingest data, you can also put a separate box (or server) for ingesting data, and have it relay data to the main box. This setup is recommended for high-traffic installations, and environment where you have multiple data centers.

Using this setup also prevents DDOS attacks, since we assume your main box can only be accessed using some kind of VPN. If there are any invalid payload being sent to your Relay instance, it will be dropped immediately. If your main box is not reachable, your Relay will keep retrying to send the data.

Please note that you don't need to have multiple data centers in different countries/regions. The region naming on the diagram is to make it easier to understand.

Copied
graph TB
  subgraph main [Main Sentry Server]
    direction TB
    nginx[External Nginx]
    sentry[Self-Hosted Sentry]

    nginx --> sentry
  end

  subgraph "US Ingest Server"
    direction TB
    internet1[Public Internet]
    relay1[Sentry Relay]
  end


  subgraph "Asia Ingest Server"
    direction TB
    internet2[Public Internet]
    relay2[Sentry Relay]
  end

    subgraph "Europe Ingest Server"
    direction TB
    internet3[Public Internet]
    relay3[Sentry Relay]
  end

  internet1 --> relay1 -- Through VPN tunnel --> main
  internet2 --> relay2 -- Through VPN tunnel --> main
  internet3 --> relay3 -- Through VPN tunnel --> main

To configure the relay, you can install Sentry Relay on your machine through the Relay Getting Started Guide. You should configure the Relay to run on proxy mode, and point it to the main Sentry server. You can also configure it to use a different port, or a different protocol (HTTP or HTTPS).

A simple configuration for the relay would be:

Copied
# Please see the relevant documentation.
# Performance tuning: https://docs.sentry.io/product/relay/operating-guidelines/
# All config options: https://docs.sentry.io/product/relay/options/
relay:
  mode: proxy
  instance: default
  upstream: https://sentry.yourcompany.com/
  host: 0.0.0.0
  port: 3000

limits:
  max_concurrent_requests: 20

# To avoid having Out Of Memory issues,
# it's recommended to enable the envelope spooler.
spool:
  envelopes:
    path: /var/lib/sentry-relay/spool.db # make sure this path exists
    max_memory_size: 200MB
    max_disk_size: 1000MB

# metrics:
#   statsd: "100.100.123.123:8125"

sentry:
  enabled: true
  dsn: "https://xxx@sentry.yourcompany.com/1"
Previous
Simple Single Node
Next
Experimental Configurations
Was this helpful?
Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").