The fastest, most direct route to instrumented code: a Honeycomb Beeline
By Chris Toshok | Last modified on January 11, 2019If you’re feeling too busy or overwhelmed to instrument your code, we are here for you.
We've talked many times about the value of instrumentation, and how it's necessary to instrument your code properly to have access to the kind of data you need to get real observability. Instrumenting your code can mean a lot of things, but in particular it means you have to augment it in many different places, which is time-consuming.
What if there was something we could do to reduce that time to almost zero?
Meet the first in a series*, the Honeycomb Beeline for Node.js!
What's a Honeycomb Beeline?
Honeycomb Beelines are the most direct path to instrumenting your code, making it easier than you ever imagined to get your code instrumented.
- Beelines create events automatically for common types of applications
- Beelines understand the standard packages you’re using, and instrument them to send useful events to Honeycomb
You can always start with a Beeline, and then later add custom instrumentation using the relevant SDK.
OK, so I have this Node app...
Honeycomb’s Beeline for Node.js provides instant, per-request visibility for your Express application.
This Beeline connects straight to common packages in the Node ecosystem to capture useful information from several different points in your application. Slice and dice requests by endpoint, status, or even User ID, with zero custom instrumentation required. And if you want, you can add custom fields to the standard events.
All you need to get started is
- A NodeJS `express` app
- Node 8+
- Your Honeycomb Write Key (found in your Honeycomb Team settings)
Give me two steps...
You literally only have to do two things to get it running:
1) Run a single npm command to install the Beeline
bash npm install --save honeycomb-beeline
At the top of your program, before any require or import statements, paste in this Honeycomb Instrumentation Block:
javascript require("honeycomb-beeline`")({writeKey: "WRITEKEY"/* ... additional optional configuration ... */,});`
And boom! That's it.
For a list of the supported packages and some queries to try out with your new-found observability, check the documentation for the Honeycomb Beeline for Node.js.
*More Beelines shipping soon!
Want your code instrumented automatically? Try us out for free!
Related Posts
Defensive Instrumentation Benefits Everyone
A lot of reasoning in content is predicated on the audience being in a modern, psychologically safe, agile sort of environment. It’s aspirational, so folks...
What Is Observability? Key Components and Best Practices
Software systems are increasingly complex. Applications can no longer simply be understood by examining their source code or relying on traditional monitoring methods. The interplay...
From Oops to Ops: SLOs Get Budget Rate Alerts
As someone living the Honeycomb ops life for a while, SLOs have been the bread and butter of our most critical and useful alerting. However,...