Transports

A transport is the mechanism in which Raven sends the HTTP request to the Sentry server. By default, Raven uses a threaded asynchronous transport, but you can easily adjust this by passing your own transport class.

The transport class is passed via the transport parameter on Client:

from raven import Client

Client('...', transport=TransportClass)

Options are passed to transports via the querystring.

All transports should support at least the following options:

timeout = 1

The time to wait for a response from the server, in seconds.

verify_ssl = 1

If the connection is HTTPS, validate the certificate and hostname.

ca_certs = [raven]/data/cacert.pem

A certificate bundle to use when validating SSL connections.

For example, to increase the timeout and to disable SSL verification:

SENTRY_DSN = 'https://examplePublicKey@o0.ingest.sentry.io/0?timeout=5&verify_ssl=0'

Eventlet

Should only be used within an Eventlet IO loop.

from raven.transport.eventlet import EventletHTTPTransport

Client('...', transport=EventletHTTPTransport)

Gevent

Should only be used within a Gevent IO loop.

from raven.transport.gevent import GeventedHTTPTransport

Client('...', transport=GeventedHTTPTransport)

Requests

Requires the requests library. Synchronous.

from raven.transport.requests import RequestsHTTPTransport

Client('...', transport=RequestsHTTPTransport)

Alternatively, a threaded client also exists for Requests:

from raven.transport.threaded_requests import ThreadedRequestsHTTPTransport

Client('...', transport=ThreadedRequestsHTTPTransport)

Sync

A synchronous blocking transport.

from raven.transport.http import HTTPTransport

Client('...', transport=HTTPTransport)

Threaded (Default)

Spawns an async worker for processing messages.

from raven.transport.threaded import ThreadedHTTPTransport

Client('...', transport=ThreadedHTTPTransport)

Tornado

Should only be used within a Tornado IO loop.

from raven.transport.tornado import TornadoHTTPTransport

Client('...', transport=TornadoHTTPTransport)

Twisted

Should only be used within a Twisted event loop.

from raven.transport.twisted import TwistedHTTPTransport

Client('...', transport=TwistedHTTPTransport)