Documentation navigation


Applications (previously known as "sites", also referred to as "apps") are Ruby, Elixir and JavaScript front-end applications monitored by AppSignal. Every application is unique by the combination of its name and environment.

A list of Applications appears on the Application index and in the application quick switcher. Every application has a parent organization, which can have multiple applications. (Exception: Organizations created by the Heroku add-on only support one application.)

Table of Contents

Adding applications

To add a new Application to AppSignal, please follow the add a new application setup wizard.


An application can have multiple environments as long as every environment uses the same application name. Every environment is currently listed separately on the Application index.

  • "Demo application" - development
  • "Demo application" - production
  • "Demo application" - staging
  • "Demo application" - test


Namespaces are a way to group error incidents, performance incidents from actions, and host metrics in your app. By default AppSignal provides three namespaces: the "web", "background" and "frontend" namespaces. You can add your own namespaces to separate parts of your app like the API or Admin panel.

Namespaces can be used to group together incidents that are related to the same part of an application. It's also possible to configure notification settings on a per-namespace level.

Read more about namespaces and how to configure them for your app.

Running multiple applications on one host

When running multiple applications on one host some odd behavior may occur. This is because the default configuration of our AppSignal libraries assume a one application per host setting.

One common problem we've seen is that Applications start reporting under different names and/or environments. Such as an application switching between the staging and production environment after a deploy or restart of an application process or worker.

To allow AppSignal to be used for multiple applications on one host we need to set the working_directory_path configuration option (Ruby / Elixir). Using this configuration option, set a working directory path per application so that the AppSignal agent will not stop agents for other Applications that are running.

Read more about the AppSignal working directory.

Removing an application

An application (app) in AppSignal is defined as the combination of the application name and environment, e.g. "My app - production". You can only delete one environment at a time through the UI.

Apps are automatically recreated when our servers receive data from your app. To remove an app, first make sure AppSignal is completely uninstalled from your applications before removing it on

Please follow the uninstall guide for the programming language of your application(s) listed below:

When your app is no longer pushing data to the AppSignal servers, delete your app on the App Settings page for your app on

  • Visit the App Settings page.
  • Scroll down to the bottom of the page.
  • In the "Delete <app name>" section, click on the "delete <app name>" button and confirm the confirmation prompt.

Your app is now scheduled for deletion. It and all its data will be removed from your organization and our servers. This may take a few minutes, after which it will disappear from your apps list.

We'd like to set cookies, read why.