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

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

There are several ways to send telemetry data to Aspecto. The instructions below show you how to add instrumentation to your applications using Aspecto SDK. The Aspecto SDK can be installed within the microservices in your local environment. Once you've installed the SDK and deploy, every time data is created on your microservice, it will appear within the Aspecto UI.
Use the tabs below to see which option is recommended based on the language you will be using.
JavaScript
TypeScript
Rails
Ruby
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.
1
require('@aspecto/opentelemetry')({
2
aspectoAuth: '*your-token-goes-here*'
3
});
4
// ... other imports ...
Copied!
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.
1
import init from '@aspecto/opentelemetry';
2
init({
3
aspectoAuth: '*your-token-goes-here*'
4
});
5
// ... other imports ...
Copied!
Installation
Install the gem using:
1
$ gem install aspecto-opentelemetry
Copied!
Or, if you use bundler, include aspecto-opentelemetry in your Gemfile.
Configuration in Code
Add this code to a new file aspecto.rb under config/initializers/:
1
# config/initializers/aspecto.rb
2
require 'aspecto/opentelemetry'
3
​
4
Aspecto::OpenTelemetry::configure do |c|
5
c.service_name = '<YOUR_SERVICE_NAME>'
6
c.aspecto_auth = '<YOUR_ASPECTO_TOKEN>'
7
# c.sampling_ratio = 1.0 # [optional]: defaults to 1.0, use aspecto app to configure remotely
8
end
Copied!
Installation
Install the gem using:
1
$ gem install aspecto-opentelemetry
Copied!
Or, if you use bundler, include aspecto-opentelemetry in your Gemfile.
Configuration in Code
1
require 'aspecto/opentelemetry'
2
​
3
Aspecto::OpenTelemetry::configure do |c|
4
c.service_name = '<YOUR_SERVICE_NAME>'
5
c.aspecto_auth = '<YOUR_ASPECTO_TOKEN>'
6
# c.env = '<CURRENT_ENVIRONMENT>' # [optional]: automatically detected for rails and sinatra
7
# c.sampling_ratio = 1.0 # [optional]: defaults to 1.0, use aspecto app to configure remotely
8
end
Copied!

Send traffic to your service

So far, you have configured your application to send telemetry to Aspecto for any inbound or outbound requests. Next, you will need to make requests to your service in order to generate the telemetry that will be sent to Aspecto.
Interact with your application by making a few requests. Telemetry data should now appear in the Aspecto UI! Continue to the next step to start access your tracing data.

Step 3: Access Your Tracing Data

Using the Trace Search tool, filter and sort through your trace data to find performance bottlenecks, errors, exceptions and application issues that have reached your production environment.
Once you've searched through and easily pinpointed where the problem lies, click on the trace to further investigate and understand why the problem exists.
Select the Trace Search icon to view a list of every trace that has been collected. Each row represents an action that took place in your system.

Filter

Use the filters in the search bar to locate a specific trace to view more information on the endpoint-to-endpoint transaction. You can filter your search using the open search field or by: environment, time frame, HTTP Method, etc. You can check all the filters here.

Sort

Now that you've filtered your search and have narrowed down the list of traces, you can sort through the remaining traces by clicking on any column header. The traces will automatically sort from ascending to descending but you can change the order of the sort using the arrow that appears next to the column name.

Observe

From the refined list, select the specific trace or set of aggregated traces you've been searching for in order to view more information. Three main sections will appear: Summary, Diagram and Timeline.

What's Next?

  • 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.