#
Quickstart Guide
Welcome to Baselime! This quickstart guide will help you get up and running with the platform in just a few steps.
All you need is:
- An AWS Account
- Permissions to deploy a CloudFormation stack with IAM role.
- A deployed application leveraging AWS Lambda and other AWS serverless services
If you do not have a deployed application, you can use our example pokedex.
#
Step 1: Sign up for Baselime
To use Baselime, you'll need to sign up for an account. You can sign up for a free account here.
- Create a workspace. Typically this will be the name of your organisation.
- Start exploring the telemetry data in your workspace sandbox.
#
Step 2: (Optional) Install the Baselime CLI
The Baselime CLI is a command-line tool that you can use to interact with the platform. Installing the CLI can make it easier to work with Baselime, unlocks Observability as Code and provides additional functionality not available in the web console. To install the CLI, follow the instructions here.
#
Step 3: Connect your AWS account
To start collecting telemetry data from your serverless application, you'll need to connect your AWS account to Baselime. This is done by deploying a CloudFormation template onto your AWS account.
To generate and download the CloudFormation template:
- Go to the Baselime Console or run the following command in the Baselime CLI:
baselime environments connect
- Follow the prompts to generate and download the template.
Next, you must deploy the template to your AWS account:
- Click the link provided by the Baselime Console or CLI to open the CloudFormation service in your AWS account
- Check the box to acknowledge that the template creates IAM roles
- Click "Create stack" to deploy the stack, making sure to use the correct credentials and region for your AWS account
We've open-sourced the CloudFormation template here.
Once the stack is deployed, telemetry data from your AWS account will be automatically ingested by Baselime and will be available through the various clients.
To verify the connection, invoke any deployed AWS Lambda function in your account and you should see data from it in the Baselime console within seconds. Additionally, you can stream all the events ingested by Baselime directly in your terminal using the baselime tail
command.
If you do not complete any of the above steps, Baselime will not be able to ingest data from your AWS account.
If you do not see any data in the Baselime UI or using the baselime tail command within seconds of completing the above steps, something went wrong. Please contact us.
#
Step 4: Explore the data
Once your AWS Account is connected, you can start exploring the telemetry data it generates. You can use the web console or the CLI (if installed) to access and analyze the data.
Baselime ingests and indexes every field and nested field in your telemetry data.
#
Accessing data in the web console
To explore the data in the web console:
- Go to the Baselime Console and sign in with your account
- Select your environment from the list of environments
- Use the various filters and tools in the console to slice and dice the data, such as:
- Filtering by resource type, key-value pair, operation type, or time range
- Searching for specific strings or regexes in the data
- Viewing the trace data for a specific request or operation
- Viewing the logs and metrics for a specific resource or operation
- Segmenting the results by specific field or nested field
#
Accessing data in the CLI
To access the data in the CLI:
If you installed the CLI, you can use the baselime query
command to interactively explore the data. Here's how it works:
- If you haven't already done so, sign in to the CLI using the
baselime login
command - Run the following command:
baselime query
- Select the service you want to query
- Select one of your saved queries or interactively build a query
- Enter the start and end time for the query (optional - defaults to the past hour)
- The command will output a table with the results of the query and a unique URL that you can share with your team
✔ Running the query
╔════════════════╤════════════════════╗
║ Aggregate │ Value ║
╟────────────────┼────────────────────╢
║ MAX(@duration) │ 8758.75 ║
╟────────────────┼────────────────────╢
║ MIN(@duration) │ 2.25 ║
╟────────────────┼────────────────────╢
║ P99(@duration) │ 322.98440000000005 ║
╚════════════════╧════════════════════╝
Follow this url: https://console.baselime.io/<workspace>/<env>/queries/lambda-duration/1653302639712
#
Guides
- Sending Data: Learn how to ingest telemetry data from your serverless applications
- Analyzing Data: Discover how to use the various interfaces provided by Baselime to analyze and understand your data
- Integrations: Find out how to connect Baselime with your favorite tools
#
Reference
- Baselime CDK Reference Guide: Learn about how to use Baselime with the AWS CDK to define your Observability as Code
- ORL Reference Guide: Learn about the Baselime Observability Reference Language (ORL) and how to use it to define observability configurations
- CLI Reference: Complete reference for the Baselime command-line interface
#
Community
Join the Baselime community to get help with using the platform, share your own experiences, and stay up-to-date with the latest developments.
- Slack: Join our Slack community to connect with other Baselime users and get real-time support from the Baselime team
- Blog: Read about the latest features, best practices, and more from the Baselime team
- Social media: Follow us on Twitter, LinkedIn, and YouTube to stay up-to-date with the latest news and updates from Baselime
We look forward to connecting with you!