# Quick Start

Welcome to Telemetry! Telemetry is a logging and analytics platform designed to help you capture, store, and query your data effortlessly. Whether you're tracking application metrics, monitoring user behavior, or analyzing business performance, Telemetry provides a seamless experience with consistent APIs across multiple programming languages.

If you're interested in learning more about how Telemetry works under the hood, check out our [Telemetry Architecture Doc](https://docs.telemetry.sh/discussion-topics/telemetry-architecture) for a detailed overview. For a more in-depth use case, such as tracking OpenAI costs by instrumenting API calls, refer to our guide on [Tracking OpenAI Costs](https://docs.telemetry.sh/guides/tracking-openai-costs).

## **Install Telemetry**

This tutorial uses JavaScript. For other languages, please refer to the individual SDKs. The overall API structure is consistent across different programming languages.

```
npm install telemetry-sh
```

## **Log some data**

Telemetry automatically creates tables when data is logged. In the following example, we log some Uber ride data to a table called `uber_rides`. Telemetry will automatically create this table and its corresponding schema with columns: `city`, `price`, and `timestamp`.

{% code overflow="wrap" lineNumbers="true" %}

```javascript
import telemetry from "telemetry-sh";

telemetry.init("YOUR_API_KEY");

telemetry.log("uber_rides", {
  city: "paris",
  price: 42,
  timestamp: new Date().toISOString()
});
```

{% endcode %}

## Explore data with our UI

You can do all sorts of different visualizations and queries in our interactive UI located at <https://telemetry.sh>.

<figure><img src="https://599670877-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQaj2pZdwnFlvkbAnGpdr%2Fuploads%2FrI3oaWQ1EXsctwpe84r3%2FCleanShot%202024-08-10%20at%2006.27.09%402x.png?alt=media&#x26;token=d7612ee8-a490-43a4-af7a-80ee0954258d" alt=""><figcaption><p>The telemetry.sh dashboard UI</p></figcaption></figure>

## Query some data

You can integrate telemetry into your product or internal dashboards by querying the data using SQL through our query API.

{% code lineNumbers="true" %}

```javascript
const results = 
  await telemetry.query(`
    SELECT
      city,
      AVG(price)
    FROM
      uber_rides
    GROUP BY
      city
  `);
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.telemetry.sh/getting-started/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.