# Getting Started with Ascent

The Ascent platform enables you to converge all of your IT data from disparate sources, manage your telemetry data, and monitor and troubleshoot your operational data in real-time. The following guide assumes that you have signed up for Apica Ascent in the cloud. **If you are not yet a registered user, please** [**follow this link and the defined steps**](https://docs.apica.io/~/revisions/aKlJTfkbFwMOe3RTTbTr/getting-started/ascent/register-and-gain-access). Once registered, use this guide to get started.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FBi8B8AB2gLUW5P68HI7E%2Fimage.png?alt=media&#x26;token=83262afc-869b-499f-99de-deca2bbc6b3f" alt=""><figcaption><p>Ascent Quick Start Process</p></figcaption></figure>

## Quick Start Process for Using Ascent

For all users that want to get started with Ascent should follow these five (5) simple steps:

1. [Collect Data from Input Sources](#step-1-start-ingesting-data)
2. [Setup and Configure Pipeline](#step-2-setup-and-configure-pipeline)
3. [Design Queries](#step-3-design-queries)
4. [Create Dashboards](#step-4-create-dashboards)
5. [Setup Alerts and Workflow](#step-5-create-alerts-and-endpoints)

In this guide, we cover the key goals and related activities of each step to ensure a quick and easy setup of Ascent.

### Step 1 - Start Ingesting Data

For a quick video on step 1 for data ingestion, click on the link below:

{% embed url="<https://www.youtube.com/embed/0bKKm44n58U?si=8f2EbhqHKBljAkgu>" %}

The goal is to ingest telemetry data (logs, metrics, traces) from relevant systems.

**Key actions include:**

* Identify all sources
* Choose agents appropriate for each data type
* Configure data collection frequency and granularity
* Ensure data normalization

**Detailed steps to start ingesting data:**

**LOG INTO ASCENT**

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2F0c1xTVGYSi0kzotUKpFw%2Fimage.png?alt=media&#x26;token=a5837bfd-23f4-40db-a30a-c94781f3c577" alt=""><figcaption></figcaption></figure>

From the menu bar, go to: Explore -> Fleet:

With Fleet you can automate your data ingestion configuration:

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FkPK2xA0wzlyHvC8jz7uz%2Fimage.png?alt=media&#x26;token=f9a1bb9d-2f56-4f8d-983a-09cbb7ae1885" alt=""><figcaption></figcaption></figure>

You'll be directed to the Fleet landing page:

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2Fj4Jytymm5562gUrpWZkY%2Fimage.png?alt=media&#x26;token=60fb0204-6511-4eca-9e79-e2022495e94b" alt=""><figcaption></figcaption></figure>

From here, you'll click "Install Agent Manager."\
\- The Agent Manager will allow you to control and configure the OpenTelemetry Collector.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FCq9xmSnyaPrhZ3v4vlx9%2Fimage.png?alt=media&#x26;token=14c88ba0-a092-44bd-afa6-d15272b6cabf" alt=""><figcaption></figcaption></figure>

Inside the "Install Agent Manager" pop-up screen, select:

* Platform: Linux
* Agent Type: OpenTelemetry Collector

Then, click 'Proceed'.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FmWinHHa54w1IOFf29fxu%2Fimage.png?alt=media&#x26;token=c20d114d-adb0-46cd-a81a-03c21245e2bf" alt=""><figcaption></figcaption></figure>

You'll be redirected to the 'Fleet README' pop-up page:

* You'll download and configure this configuration file to start ingesting data.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2Frq7hTNd2ASBK2VbolY2y%2Fimage.png?alt=media&#x26;token=746faae0-2a60-4c51-8fb6-809eebe6ee60" alt=""><figcaption></figcaption></figure>

You'll download 2 files:

* The README.txt contains instructions for how to install the Agent Manager and OpenTelemetry Collector.
* The fleet-install.sh is a preconfigured script that you'll run on your Linux host to start ingesting data into Ascent automatically:

<div align="left"><figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FizOPUGdjKrJu6tf4fdd5%2Fimage.png?alt=media&#x26;token=eed2837e-060f-47cd-9b69-58203a14e1ce" alt=""><figcaption></figcaption></figure></div>

On your Linux host, start by creating a file by running this command:

<div align="left"><figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2F5mrx4x3LD5Y2oVD4PTP0%2FScreenshot%202025-05-23%20at%2011.08.17%E2%80%AFAM.png?alt=media&#x26;token=0b4cbb0a-cea0-44a8-bb79-6fdba823c24c" alt=""><figcaption></figcaption></figure></div>

Paste the contents of 'fleet-install.sh' into nano editor:

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FuJZYAcy2DVlssNqHy6Q7%2FScreenshot%202025-05-23%20at%2011.08.39%E2%80%AFAM.png?alt=media&#x26;token=b1be191f-70aa-4b4c-89cd-5c9a09e3acfc" alt=""><figcaption></figcaption></figure>

Run the Fleet-install.sh with the command below:

* sudo ./fleet-install.sh

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FDHmVeX6YxxjK1zotxTIV%2FScreenshot%202025-05-23%20at%2011.10.54%E2%80%AFAM.png?alt=media&#x26;token=90c3c277-4c29-4043-88b3-213427c1c578" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FbbazkNfvLlpKcyemanDM%2FScreenshot%202025-05-23%20at%2011.12.30%E2%80%AFAM.png?alt=media&#x26;token=fb25804b-af70-44e2-ae86-555b38dbb2ac" alt=""><figcaption></figcaption></figure>

Once the script completes, you'll see the agent in the Fleet screen as 'Active':

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FWbzl8MZIg6UtEOo1OEJb%2Fimage.png?alt=media&#x26;token=3247eb37-6d83-4b2e-94cb-161c1d3f99d9" alt=""><figcaption><p>Confirmation of Active Fleet Agent</p></figcaption></figure>

You can then confirm that data is flowing into the system (Go to 'Explore -> Logs & Insights):

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FhKYiVwVMyKHDgpug3QI4%2FScreenshot%202025-05-23%20at%204.49.42%E2%80%AFPM.png?alt=media&#x26;token=4aeea186-0179-442a-baa0-f6a906937230" alt=""><figcaption><p>Log Data Flow</p></figcaption></figure>

**Additional Links to helpful docs include:**

* [Data sources overview](https://docs.apica.io/data-sources/overview)
* [Integrations overview](https://docs.apica.io/integrations/overview)

### Step 2 - Setup and Configure Pipeline

For a quick video on setup and configuration of a pipeline, click on the link below:

{% embed url="<https://www.youtube.com/embed/ZgL3wV9yb9k?si=fL0uxMA-NZ3YpL>\_\_" %}

The goal is to transport and process the collected data.

**Key actions include:**

* Select or configure a data pipeline
* Define data routing rules
* Apply transformations, filtering, or enrichment if needed

**Links to related docs include:**

* [Configure pipelines](https://docs.apica.io/flow/pipeline-management/data-flow-pipelines-new)
* [Visualize pipelines](https://docs.apica.io/flow/pipeline-management/data-flow-pipelines)
* [Forwarding data](https://docs.apica.io/flow/pipeline-management/mapping-applications)

### Step 3 - Design Queries

For a quick video on designing queries and reports, click on the link below:

{% embed url="<https://www.youtube.com/embed/_V8zupniOBA?si=dEtzv7gJyjBMfGnT>" %}

The goal is to enable insights by querying telemetry data.

**Key actions include:**

* Understand the query language used
* Create baseline queries for system health
* Optimize queries for performance and cost
* Validate query results

**Links to related docs include:**

* [Data explorer overview](https://docs.apica.io/data-management/overview-1)
* [Query builder](https://docs.apica.io/data-management/overview-1/query-builder)
* [Widget](https://docs.apica.io/data-management/overview-1/widget)

### Step 4 - Create Dashboards

For a quick video on creating dashboards, click on the link below:

{% embed url="<https://www.youtube.com/embed/yGzpLaMKLQg?si=_MlP_PZS_ECCExyu>" %}

The goal is to visualize system performance and behavior in real time.

**Key actions include:**

* Use visual components
* Organize dashboards by domain
* Incorporate filters
* Enable drill-down for troubleshooting.

**Links to related docs include:**

* [Dashboards overview](https://docs.apica.io/getting-started/overview)

### Step 5 - Create Alerts and Endpoints

For a quick video on creating alerts and endpoints, click on the link below:

{% embed url="<https://www.youtube.com/embed/iS9bElHtYb4?si=vigh0S7-OacJoclj>" %}

The goal is to detect anomalies and automate response actions.

**Key actions include:**

* Define alerting rules
* Set up alert destinations
* Establish escalation policies and on-call schedules
* Integrate with incident management workflows and postmortem tools

**Links to related docs include:**

* [Alerts overview](https://docs.apica.io/~/revisions/aKlJTfkbFwMOe3RTTbTr/autonomous-insights/alerts)
* [Alerting on queries](https://docs.apica.io/~/revisions/aKlJTfkbFwMOe3RTTbTr/autonomous-insights/alerts-simple-anomaly)
* [Alerting on logs](https://docs.apica.io/~/revisions/aKlJTfkbFwMOe3RTTbTr/autonomous-insights/alerts-1)

## Additional Resources

Here are helpful links to other "Getting Started" technical guides:

* [Getting Started with Metrics](https://docs.apica.io/~/revisions/aKlJTfkbFwMOe3RTTbTr/getting-started/ascent/getting-started-with-metrics)
* [Getting Started with Logs](https://docs.apica.io/~/revisions/aKlJTfkbFwMOe3RTTbTr/getting-started/ascent/getting-started-with-logs)
* [Get acquainted with the Apica Ascent UI](https://docs.apica.io/~/revisions/aKlJTfkbFwMOe3RTTbTr/product-overview/the-ascent-ui)
* [Configure your data sources](https://docs.apica.io/~/revisions/aKlJTfkbFwMOe3RTTbTr/integrations/overview)
* [Configure Apica Ascent to send alerts to your email server](https://docs.apica.io/~/revisions/aKlJTfkbFwMOe3RTTbTr/admin/email-configuration-setup)
* [Add and configure alert destinations like email, Slack, and PagerDuty](https://docs.apica.io/~/revisions/aKlJTfkbFwMOe3RTTbTr/integrations/list-of-integrations/alert-destinations)
* [Configure SSO using SAML](https://docs.apica.io/~/revisions/aKlJTfkbFwMOe3RTTbTr/admin/single-sign-on-configuration)
* [Configure RBAC](https://docs.apica.io/~/revisions/aKlJTfkbFwMOe3RTTbTr/observe/log-management-overview/configuring-rbac)
