AppSignal Wrap

We're excited to introduce AppSignal Wrap, a lightweight command-line tool that makes it easy to monitor any process on your server.

From cron jobs and backup scripts to database servers and long-running background workers, Wrap eliminates blind spots by automatically sending logs, check-ins, and error reports to AppSignal. With just a single command, you can gain full visibility into your processes and be alerted the moment something goes wrong.

What Is AppSignal Wrap?

AppSignal Wrap is a lightweight command-line tool for process monitoring, built on AppSignal APM. It eliminates blind spots across your app by automatically tracking logs, errors, and uptime for any server process—from cron jobs and backup scripts to long-running workers.

With Wrap, you can:

• Manage Logs: Quickly find, filter, and query process logs in real time.
• Monitor Uptime with Check-ins & Heartbeats: Track scheduled jobs and long-running processes with cron and heartbeat monitoring.
• Track Errors: Detect and resolve exceptions before they affect users.
• Analyze Performance: Identify slow or failing processes instantly.

Whether you're managing cron jobs, shell scripts, or long-running workers, Wrap keeps you informed.

Quick Two-Step Installation

You can install AppSignal Wrap and start monitoring in minutes. No bloatware and no complex setup.

Step 1: Install Wrap

Run the following command to install Wrap straight from the command line:

curl -sSL https://github.com/appsignal/appsignal-wrap/releases/latest/download/install.sh | sudo sh

Alternatively, download Wrap from GitHub.

Step 2: Wrap Your Processes

After installation, wrap your processes with appsignal-wrap:

export APPSIGNAL_APP_LEVEL_API_KEY=[APP_LEVEL_API_KEY]
appsignal-wrap [NAME] -- [COMMAND]

Replace [NAME] with the name you want AppSignal to identify the process as, and [COMMAND] with the command you want to monitor. For example:

appsignal-wrap payment-script -- bash /var/app/backup.sh

AppSignal will now track this process, collect metrics, and alert you if something goes wrong.

Leverage Check-ins and Heartbeats with Wrap

With Wrap, you can use Cron Check-ins and Heartbeat Check-ins to monitor a process's execution times or confirm that it's still running.

To do this with Wrap, you need to use the --cron and --heartbeat command line options:

appsignal-wrap payment-script --cron -- bash /var/app/payment_script.sh
appsignal-wrap payment-script --heartbeat -- bash /var/app/payment_script.sh

Be sure to configure the matching Check-in or Heartbeat in your AppSignal dashboard. Once set up, you'll see real-time insights into process performance and health, all from a simple overview:

Why Use AppSignal Wrap?

AppSignal Wrap gives you full visibility into your background jobs and server processes, helping you catch issues before they affect production. With Wrap, you can:

• Eliminate blind spots: Monitor cron jobs, scripts, and long-running processes.
• Get proactive alerts: Be notified of process failures before they impact users.
• Keep tasks on schedule: Use cron and heartbeat check-ins to ensure jobs run on time.
• Unify monitoring: Collect logs, errors, and performance data in one place.

Get Started with AppSignal Wrap

Ready to stay on top of your background jobs and server processes? Get started with Wrap today:

• Start your free trial today
• Learn more about Process Monitoring
• Read the AppSignal Wrap documentation