AppSignal Ruby configuration
Configuration. Important, because without it the AppSignal Ruby gem won't know which application it's instrumenting or in which environment.
In this topic we'll explain how to configure AppSignal, what can be configured in the Ruby gem, what's the minimal configuration needed and how the configuration is loaded.
Minimal required configuration
# config/appsignal.yml production: active: true push_api_key: "1234-1234-1234" name: "My app"
# Environment variables export APPSIGNAL_PUSH_API_KEY="1234-1234-1234" export APPSIGNAL_APP_NAME="My app" export APPSIGNAL_APP_ENV="production"
# Appsignal.configure helper Appsignal.configure(:production) do |config| config.push_api_key = "1234-1234-1234" config.name = "My app" end
The above configuration options are the only required options. All other configuration is optional.
If you use Rails you can even skip the app name, we will use the name of your Rails application.
If you use a framework that is aware of environments and is supported by the AppSignal gem, the environment is detected automatically.
Configuration methods
YAML configuration file
The AppSignal Ruby gem can be configured with a configuration file. During installation the Ruby gem will create a config/appsignal.yml
file, if selected. In this file some default configuration is supplied and can be modified to fit your application's needs. This config/appsignal.yml
file supports ERB tags so that system environment variables can also be loaded in this file.
The config/appsignal.yml
configuration examples shown for configuration options will use the default
YAML anchor. The AppSignal installer will create an config/appsignal.yml
file with this anchor by default. If not present, make sure you add the config option to the correct environment.
# config/appsignal.yml # Define the "defaults" anchor default: &defaults name: "My app" # Supports ERB push_api_key: "<%= ENV['APPSIGNAL_PUSH_API_KEY'] %>" production: # Loads the defaults in the production environment by referencing the anchor <<: *defaults # production environment specific configuration active: true
Multiple app environments
Multiple app environments can be configured in this file using root-level keys.
# Example: config/appsignal.yml development: # Development app environment active: true production: # Production app environment active: true test: # Testing app environment active: false # Disabled for test environment
To avoid having to repeat the configuration for every app environment, we can use YAML anchors to extend YAML objects.
# Example: config/appsignal.yml default: &defaults active: true development: # Development app environment <<: *defaults production: # Production app environment <<: *defaults test: # Testing app environment <<: *defaults active: false # Overwrites the inherited active config option from "defaults"
It's not possible to only configure a defaults
anchor and have it apply to all environments automatically. Every environment needs to be configured in the YAML file with a root-level key and extend from this defaults
anchor.
System environment variable
AppSignal can also be configured using system environment variables on the host the application AppSignal is monitoring is running on. This is common on platforms such as Heroku.
Make sure these environment variables are configured in the way that's compatible with your Operating System and that the values get loaded before your app with AppSignal is started.
export APPSIGNAL_APP_NAME="My app"
Appsignal.configure
helper
AppSignal can also be configured using Ruby code. For more information on how to configure AppSignal this way, read our load order guide.
In Rails apps, make sure to configure the AppSignal gem to start after Rails is initialized, otherwise the config set with Appsignal.configure
is ignored when called in a Rails initializer like config/initializers/appsignal.rb
.
# Load AppSignal require "appsignal" # Configure AppSignal Appsignal.configure do |config| # Example config config.activejob_report_errors = "discard" config.sidekiq_report_errors = :discard config.ignore_actions = ["My ignored action", "My other ignored action"] config.request_headers << "MY_HTTP_HEADER" config.send_params = true config.enable_host_metrics = false end Appsignal.start # Do not call this in Rails apps
Example configuration file
Here's an example of an appsignal.yml
configuration file. It's recommended
you only add the configuration you need to your configuration file.
For the full list of options, please see the configuration options page.
# config/appsignal.yml default: &defaults # Your Push API Key, it is possible to set this dynamically using ERB. Required push_api_key: "<%= ENV['APPSIGNAL_PUSH_API_KEY'] %>" # Your app's name as reported on AppSignal.com. Required name: "My App" # Your server's hostname. Optional, auto detected hostname: "frontend1.myapp.com" # Add default instrumentation of net/http. Default: true instrument_net_http: true # Skip session data, if it contains private information. Default: false skip_session_data: true # Ignore these errors (Optional) ignore_errors: - SystemExit # Ignore these actions, used by our Loadbalancer. Optional ignore_actions: - IsUpController#index # Enable allocation tracking for memory metrics. Default: true enable_allocation_tracking: true # Configuration per environment, leave out an environment or set active # to false to not push metrics for that environment. development: <<: *defaults active: true # Enable more logging in the `appsignal.log` file. Optional log_level: true staging: <<: *defaults # Configure AppSignal to be active for this environment. Required active: true production: <<: *defaults # Configure AppSignal to be active for this environment. Required active: true # Set different path for the log file. Optional, auto detected log_path: "/home/my_app/app/shared/log" # Set AppSignal working dir. Optional, auto detected working_directory_path: "/tmp/appsignal" # When it's not possible to connect to the outside world without a proxy. # Optional http_proxy: "proxy.mydomain.com:8080"