Get a notification when your Shell code is done executing

LogSnag makes it easy to trigger push notifications when your Shell job or process finishes running.

These days we can use Shell for almost anything, be it a simple function, a complex algorithm, or anything that comes to mind. Usually, what we want Shell to do happens very quickly, and we don't even have to wait for it to finish.

Long-running Shell tasks are a problem

However, sometimes you are writing a Shell code, process, or job that may take a long time to run. For example, you may decide to crawl a website or run a long-running parsing algorithm.

I'm sure almost every developer has, at some point, written a Shell code that takes a long time to run. They then had to continuously check the task, wait for it to finish running, and ensure the Shell code was working as expected. As you can see, this gets tedious very quickly and wastes time and effort.

Push notifications fix this problem

One common way to solve this is to track the status of our Shell code and send a push notification when the code is done running or when it fails. By doing so, we can leave and forget about the long-running Shell code and focus on the important things we need to do, and by the time something happens, we will instantly get a push notification to let us know.

To do so, we can use LogSnag to track the status of our Shell code. LogSnag is a simple, easy-to-use, robust event tracking and notification system that lets you track your Shell code and send push notifications when something happens.

Let's walk you through setting up and using LogSnag to track the status of our Shell code.


Setting up LogSnag

  1. Sign up for a free LogSnag account.
  2. Create your first project from the dashboard.
  3. Head to settings and copy your API token.

Shell code snippets

Now that we have our account and project setup, we can copy the following code snippet, update the values with your information, and paste it into your code.

Using Shell with Httpie
printf '{"project":"my-project","channel":"crawler","event":"Crawling is complete","description":"Successfully crawled 1,230 pages.","icon":"🔥","notify":true}'| http  --follow --timeout 3600 POST 'https://api.logsnag.com/v1/log' \
 Content-Type:'application/json' \
 Authorization:'Bearer YOUR_API_TOKEN'
Using Shell with wget
wget --no-check-certificate --quiet \
  --method POST \
  --timeout=0 \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --body-data '{"project":"my-project","channel":"crawler","event":"Crawling is complete","description":"Successfully crawled 1,230 pages.","icon":"🔥","notify":true}' \
   'https://api.logsnag.com/v1/log'

Shell integration details

LogSnag provides several other features that can be used to simplify your job as a developer. For example, suppose you're working with a team. In that case, you can also add the rest of your team to your LogSnag project and allow them to see the status of your Shell code and receive push notifications when something important happens.

LogSang also keeps track of your previous events, so you can see what has happened in the past and search through previous events. We found this to be very powerful when we are working on larger projects and need to see what has happened in the past.

In addition, LogSnag allows you to create simple dashboards, charts, and graphs that give you more insight into your code and the events you track.

Other use-cases for LogSnag

  1. Track payment events via Shell

  2. Track user signup events via Shell

  3. Track your Shell cron jobs

  4. Track waitlist signup events via Shell

  5. Track user sign in events in Shell

  6. Monitor when a user exceeds the usage limit for your Shell service

  7. Monitor when a new feature is used in your Shell application

  8. Monitor suspicious activity in your Shell application

  9. Monitor when a user is being rate limited in your Shell application

  10. Monitor when database goes down in your Shell application

  11. Monitor your CPU usage in your Shell application

  12. Monitor memory usage in your Shell application

  13. Monitor high disk usage in your Shell application

  14. Track when a file is uploaded to your Shell application

  15. Track when a form is submitted to your Shell application

  16. Track canceled subscriptions in your Shell application

  17. Monitor failed payments for your Shell application

  18. Monitor your CI/CD build status for your Shell application

  19. Monitor when a user changes their email address in your Shell application

    View all common use-cases with Shell