Quick Start
Ready to gain visibility and a deeper understanding of your distributed system? Get started with Aspecto in just 3 easy steps:
    1.
    ​Sign up an Aspecto account (it's free!)
    2.
    Install our SDK
    3.
    Access and observe your tracing data

Step 1: Sign Up for an Account

​Use this link to sign up for an Aspecto account or navigate to the Aspecto website and select the Get Started button.
Once you've created an account, you can play around with the Aspecto UI using our simulated playground system or you can continue to step 2 and install our SDK.
Not ready to commit? Use our playground to get a glimpse of Aspecto in action.

Step 2: Install the Aspecto SDK

The Aspecto SDK can be installed within the microservices in your local environment. Once you've installed the SDK, every time data is locally created on your microservice, it will appear within the Aspecto UI.
Start by installing the Aspecto package using npm:
1
$ npm install @aspecto/opentelemetry
Copied!
At the beginning of each project, add the following code. Make sure to use your authentication token, which can be found here.
JavaScript
TypeScript
1
require('@aspecto/opentelemetry')({
2
local:true,
3
aspectoAuth: '*your-token-goes-here*'
4
});
5
// ... other imports ...
Copied!
1
import init from '@aspecto/opentelemetry';
2
init({
3
local: true,
4
aspectoAuth: '*your-token-goes-here*'
5
});
6
// ... other imports ...
Copied!
Once the process begins, a link will be outputted. Click on the link to open our Live Traces tool and view traces from every microservice that is running in your environment.
1
=====================================================================================================================================
2
| |
3
| πŸ•΅οΈβ€β™€οΈSee the live tracing stream at https://app.aspecto.io/app/live-traces/sessions?instanceId=14243e72-14dc-4255-87af-ef846b247578 |
4
| |
5
=====================================================================================================================================
Copied!
The provided link is valid for a limited period of time.

Step 3: Access Your Tracing Data

The Live Traces tool within the Aspecto UI presents a list of all your live traces, making it easy to view every action that takes place in your system. It is a powerful way to proactively develop and debug your application, preventing issues from reaching production.
By clicking on any trace, view all microservice dependencies and how every component within your distributed system communicates or relies on one another.
Using the trace diagram, summary, and timeline, you can observe and understand how a code change will affect your entire system as well as pinpoint performance issues and other anomalies, like errors and exceptions.

Bonus: Taking Aspecto One Step Further

πŸ‘‰ Check out our Advanced guide to customize what data is sent to Aspecto and to enable customized settings according to your use case.
πŸ”Ž Investigate your tracing data and pinpoint areas that can be improved or fixed.
πŸš€ Want to deploy to production? Create sampling rules to determine exactly what data should be sent to Aspecto in production.
​
Last modified 13d ago