Sha256: e4ed9e7a200ff1e9fe89134ae5a99ae4306510e2a2fd281578febf53c09ea081

Contents?: true

Size: 1.06 KB

Versions: 15

Compression:

Stored size: 1.06 KB

Contents

[[getting-started-rack]]
== Getting started with Rack

Add the gem to your `Gemfile`:

[source,ruby]
----
gem 'elastic-apm'
----

Create a file `config/elastic_apm.yml`:

[source,yaml]
----
server_url: http://localhost:8100
secret_token: ''
----

Include the middleware, start (and stop) Elastic APM when booting your app:

[source,ruby]
----
# config.ru

app = lambda do |env|
  [200, {'Content-Type' => 'text/plain'}, ['ok']]
end

# Wraps all requests in transactions and reports exceptions
use ElasticAPM::Middleware

# Start an instance of the Agent
ElasticAPM.start(service_name: 'NothingButRack')

run app

# Gracefully stop the agent when process exits.
# Makes sure any pending transactions are sent.
at_exit { ElasticAPM.stop }
----

[float]
[[getting-started-sinatra]]
==== Sinatra example

[source,ruby]
----
# Example config.ru

require 'sinatra/base'

class MySinatraApp < Sinatra::Base
  use ElasticAPM::Middleware
  
  # ...
end

# Takes optional ElasticAPM::Config values
ElasticAPM.start(app: MySinatraApp, ...)

run MySinatraApp

at_exit { ElasticAPM.stop }
----

Version data entries

15 entries across 15 versions & 1 rubygems

Version Path
elastic-apm-2.1.2 docs/getting-started-rack.asciidoc
elastic-apm-2.1.1 docs/getting-started-rack.asciidoc
elastic-apm-2.1.0 docs/getting-started-rack.asciidoc
elastic-apm-2.0.1 docs/getting-started-rack.asciidoc
elastic-apm-2.0.0 docs/getting-started-rack.asciidoc
elastic-apm-1.1.0 docs/getting-started-rack.asciidoc
elastic-apm-1.0.2 docs/getting-started-rack.asciidoc
elastic-apm-1.0.1 docs/getting-started-rack.asciidoc
elastic-apm-1.0.0 docs/getting-started-rack.asciidoc
elastic-apm-1.0.0.beta2 docs/getting-started-rack.asciidoc
elastic-apm-1.0.0.beta1 docs/getting-started-rack.asciidoc
elastic-apm-0.8.0 docs/getting-started-rack.asciidoc
elastic-apm-0.7.4 docs/getting-started-rack.asciidoc
elastic-apm-0.7.3 docs/getting-started-rack.asciidoc
elastic-apm-0.7.2 docs/getting-started-rack.asciidoc