Skip to content

Latest commit

 

History

History
118 lines (69 loc) · 5.4 KB

trace-to-keymetrics.md

File metadata and controls

118 lines (69 loc) · 5.4 KB
layout title description permalink
docs
Migrating From RisingStack Trace To Keymetrics
Migrating From RisingStack Trace To Keymetrics
/docs/usage/from-trace-to-keymetrics/

https://i.imgur.com/17Wa4fu.png

From Trace to Keymetrics

As you might have seen, Trace and Keymetrics had partnered up. Trace was the tool built by the engineers of RisingStack, a monitoring SaaS which use an agent to provide insights into Node.js services.

The partnership of RisingStack & Keymetrics includes merging Trace and its userbase into Keymetrics, and providing technical help to build a superior Node.js monitoring tool.

This piece of documentation is for former Trace users and will help them understand how do properly migrate from Trace to Keymetrics

What is required to use Keymetrics?

It requires a very short amount of time to use Keymetrics and PM2 in production. Basically you will just need to use pm2 as a process manager / node.js runtime and use one to command to link it to Keymetrics.

1/ Start your application with PM2




Keymetrics is built on top of PM2, a well known, Open Source process manager that improves performance and reliability of your Node.js applications.

Getting started with PM2 is as easy as:

# Install PM2 globally
$ npm install pm2 -g
# Start your Node.js application
$ pm2 start app.js

Your app is now daemonized, monitored and kept alive forever.

Some of the key features are:

Discover all PM2 features via our official documentation.

2/ Link PM2 to Keymetrics

Now let's get this Node.js application monitored by Keymetrics. Make sure you've created an account and just copy the pm2 link <secret> <public> displayed in the popup and paste it into your terminal.

https://i.imgur.com/3bg5Wrg.png

3/ Monitor

Instantly, you will see the Keymetrics Dashboard revealed and you can monitor some of the Key Metrics of your application.

https://keymetrics.io/assets/images/homepage-tour/screen1.jpeg

Feature comparison between Trace and Keymetrics

Transaction Tracing

As Trace, Keymetrics provides a Transaction Tracing system that allows you to identify which HTTP calls are slow and why they are slow. Unlike Trace, we retrieve all the traces generated by your application, not only the one with issues (so you can inspect even how healthy routes behave)

https://keymetrics.io/assets/images/homepage-tour/screen6.jpeg

Learn more about Transaction Tracing

Memory & CPU profiling

The Trace tracing feature is similar to what can be found under the "Profiling" tab of Keymetrics App:

https://keymetrics.io/assets/images/tour/screen4@2x.jpg?v=d02a2e7337

For CPU profiling, it can be started directly from the Keymetrics interface and stopped any time you want. You will then get a visualisation of the stack and you will still have the ability to download the CPU profiling file.

About Memory Profiling, you have the exact same ability to heapdump memory any time you want.

Learn more about Memory & CPU Profiling

Errors & Exceptions

You can find and filter errors in your code and see their stack traces and occurrence data. We also display line code number and logs before exceptions

https://keymetrics.io/assets/images/homepage-tour/screen5.jpeg

Learn more about Exceptions Tracking

Metrics

With Keymetrics you can also monitor criticals metrics and also have data retention of 14 days. This will be extended to 60 days in the next month.

https://keymetrics.io/assets/images/homepage-tour/screen3.jpeg

Learn more about Metrics Monitoring

Features in development

The Trace Uptime Webchecks and Topology overview will be developped in the following months in partnership with RisingStack team.

Some Nifty Keymetrics Features

More about Keymetrics

Fly over here

What is next

Also, the teams of Keymetrics & RisingStack created a webinar which will help you in the migration & the unanswered questions you have. Here is the link of the upcoming webinar.