Heroku installation
Last updated 2023-05-04
The Signal Sciences agent can be deployed with Heroku. The installation process is compatible with any of the language buildpacks.
Installation
Log in to Heroku.
$ heroku loginAdd the Signal Sciences buildpack to your application settings.
$ heroku buildpacks:add --index 1 https://dl.signalsciences.net/sigsci-heroku-buildpack/sigsci-heroku-buildpack_latest.tgzNOTE
The Signal Sciences buildpack must run first or before your application's primary buildpack.
In your
Procfile
file, addsigsci/bin/sigsci-start
so it precedes your existing start command:$ web: sigsci/bin/sigsci-start YOUR-APPLICATION'S-START-COMMANDExample:
$ web: sigsci/bin/sigsci-start node index.jsLocate the Agent Keys for your Signal Sciences site:
Log in to the Signal Sciences console.
From the Sites menu, select a site if you have more than one site.
Click Agents in the navigation bar. The agents page appears.
Click View agent keys. The agent keys window appears.
Copy the Agent Access Key and Agent Secret Key.
Add the Signal Sciences agent keys to your application's environment variables.
$ heroku config:set SIGSCI_ACCESSKEYID=access-key-goes-here$ heroku config:set SIGSCI_SECRETACCESSKEY=secret-key-goes-hereDeploy your application. Heroku applications are typically deployed with the following commands:
1$ git add .2$ git commit -m "my comment here"3$ git push heroku main
Configuration
Each time you deploy your application, Heroku will automatically assign a new random name for the agent. An agent name for each deployment can be specified by setting the
SIGSCI_SERVER_HOSTNAME
environment variable:$ heroku config:set SIGSCI_SERVER_HOSTNAME=agent-nameAgent access logging can be enabled by setting the
SIGSCI_REVERSE_PROXY_ACCESSLOG
environment variable:$ heroku config:set SIGSCI_REVERSE_PROXY_ACCESSLOG /tmp/sigsci_access.logThe buildpack will install the latest version of the Signal Sciences agent by default. You can specify which agent version to install by setting the
SIGSCI_AGENT_VERSION
environment variable:$ heroku config:set SIGSCI_AGENT_VERSION=1.15.3
Additional configuration options are listed on the agent configuration page.
Do not use this form to send sensitive information. If you need assistance, contact support. This form is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.