---

StackHub Guides

Below you'll find information on (hopefully) everything you need to know about getting the most out of StackHub. But please get in touch if you don't find what you need here.

Downloading the daemon

You can download the daemon and see configuration options on the daemon information page.

Configuring your logging framework

See the individual guides on the Log4J page and the Logback page.

Setting up the daemon as a service

Here is a sample init.d file for Linux. If you have examples for other systems, please submit them!

Filtering events

You can control what events get sent from the StackHub daemon up to your Event Feed by creating filters. Click on the scissor icon to the right of any event in your Event Feed to begin. StackHub guesses at a regular expression to use as the filter, but you can modify it to suit your needs. After you create the filter, StackHub applies it to the events in your Event Feed, removing the ones that match. This filter is also sent down to the daemon, so that matching events are filtered out inside your network, saving us both bandwidth. You can change your filters in real-time for every node in your system without restarting your apps or even logging into the servers. So easy!

Event templates

Event templates are a means to an end at StackHub. By telling StackHub what various events look like, it knows to group similar events together, track occurrences of that event over time, notify you of thresholds around that event, and let you see historical graphs of that event over time. But before you can see graphs or set alerts, you need to create a template around an event. Usually you'll do this by clicking on the group icon to the right of any event in your Event Feed. As with event filters, StackHub guesses at regexp to use as the matcher, but you'll probably want to modify it to be more generic. And just like the event filters, your event templates are sent down to the daemon so similar events can be aggregated there. Once you've created a template for an event, future events that match the template show up differently in your Event Feed. You'll be able to create alerts around the event, as well as see historical trends across various timeframes.

Alerts

Once you have an event template set up for a particular type of event, you can tell StackHub to alert you when that event happens more than X times in a given period of time. Begin by clicking on the bell icon next to a templated event in your Event Feed. When an alert is triggered, you'll get one and only one email about it until you mark it as resolved. Note that alerts are determined on a per-machine basis, so you'll get one alert email for each node in your network that triggers the threshold for a given event.

Historical trends

Once you have an event template set up for a particular type of event, you can see how often that event has occurred over time by clicking on the chart icon next to a templated event in your Event Feed. You'll see three separate charts showing different timeframes: the last hour by minute, the last few days by hour, and the last few weeks by day. The data is broken down by node, so you can see not just trends over time, but distribution across the nodes in your network. Hover over any bar in a chart to show detailed information.

Inviting others to your App

You can invite others to have access to an App that you have created. Click on the invitation icon to choose which Apps to share, and whom to invite. You can invite multiple people by separating their email addresses with a space (e.g., "foo@example.com bar@example.com")