Menu

Setup

AppSignal's Heroku metrics, error reporting, and dashboards are available for Cedar (Legacy Platform) and Fir generation applications and can be configured in just a few steps.

Cedar (Legacy Platform) applications

For Heroku Cedar applications you can configure AppSignal's metrics, error reporting and dashboards with a Logplex Log Drain.

If you also want to access and manage your Heroku logs in AppSignal, you should instead configure the Heroku Log drain for AppSignal Logging.

You only have to set up this log drain once per application and it will provide data for all features such as Heroku platform errors, dashboards and host metrics.

This Heroku log drain setup will send only metrics to AppSignal. AppSignal will receive logs from Heroku, but they will be discarded. To send both metrics and logs to AppSignal, follow the Heroku log drain setup in our Logging documentation instead.

Shell
heroku drains:add "https://appsignal-endpoint.net/logplex?api_key=<push_api_key>&name=<app_name>&environment=<app_environment>"

Make sure to replace the placeholders (<push_api_key>, <app_name> and <app_environment>) with your AppSignal organization's Push API key, your app's name and environment. Make sure your app's name and environment match exactly with your app's AppSignal configuration. These values are case sensitive.

You can find your Push API key, app name and environment on AppSignal.com at "App settings > Push & Deploy".

Once the log drain is set up, Heroku platform errors and dashboards should appear automatically. Additional setup is required for Host Metrics.

Fir applications

You can configure AppSignal's metrics, error reporting, and dashboards for Heroku Fir applications with a Telemetry drain.

Shell
heroku telemetry:add --app <heroku_app_name> <collector-endpoint-url> --headers '{"AppSignal-Config-Name":"<app_name>","AppSignal-Config-Environment":"<app_environment>","AppSignal-Config-PushApiKey":"<push_api_key>","AppSignal-Config-LanguageIntegration":"heroku-fir","OpenTelemetry-HostName":"heroku"}'

Make sure to replace the following placeholders:

  • <heroku_app_name> with the application name in Heroku
  • <collector-endpoint-url> with the Hosted Collector URL, which will be generated for you during the AppSignal installation steps
  • <app_name> with your application's name
  • <app_environment> with your application's environment
  • and <push_api_key> with your AppSignal organization's Push API key.

After this, Heroku will create a telemetry drain and send all telemetry signals (traces, metrics, and logs) to AppSignal. This will populate host metrics for the Heroku platform, metrics from first-party services (Heroku Postgres and Heroku Redis) that your application uses, and will store any logs from the Heroku Platform API.