blob: 8ac63e863dd1daf49f61dd725fe97e2a1751b9ed [file] [view]
---
{
"title": "Quick Start",
"sidebar_label": "Quick Start",
"language": "en-US",
"description": "How to quickly try out the DOG Stack observability solution? This article walks through one-click deployment with Docker Compose and a complete tour of the Doris App plugin, log search, trace analysis, dashboards, and alerting.",
"keywords": [
"DOG Stack quick start",
"Docker Compose",
"Doris App plugin",
"Grafana",
"OpenTelemetry",
"log search",
"trace analysis",
"dashboard",
"alerting"
]
}
---
<!-- Knowledge type: operational steps -->
<!-- Applicable scenario: observability quick validation / DOG Stack onboarding -->
The easiest way to experience DOG Stack is to visit the [online demo](https://observability-demo.velodb.io/) — no deployment required. If you want to run your own instance, getting started with Docker Compose is just as easy.
## Deployment
```Bash
git clone https://github.com/ai-observe/ai-observe-stack.git
cd ai-observe/demo
docker compose up -d
```
This launches a complete DOG Stack along with a demo e-commerce application made up of 10+ microservices.
Open your web browser, navigate to http://localhost:33000/grafana/plugins, search for `doris`, and click the **Doris App** entry.
![Doris App plugin](https://cdnd.selectdb.com/images/upload/dogstack/quickstart_plugin.png)
Then click the **Enable** button to enable the Doris App.
![Enable Doris App](https://cdnd.selectdb.com/images/upload/dogstack/quickstart_enable.png)
Once enabled, you can find the Doris App under "More apps" in the left-side menu. Click "Doris App" to start exploring.
![Doris App entry](https://cdnd.selectdb.com/images/upload/dogstack/quickstart_apps.png)
## Search
In the Doris App, choose `Doris` as the data source, `otel` as the database, and `otel_logs` as the table you will see some data. The UI should look familiar and easy to use for Kibana users.
![Log data source](https://cdnd.selectdb.com/images/upload/dogstack/quickstart_logs.png)
Try entering `body:error` in the search box to find logs whose body field contains the word `error`.
![Search body:error](https://cdnd.selectdb.com/images/upload/dogstack/quickstart_search.png)
## Traces
Click **Traces** under the **Doris App** menu to explore and analyze traces.
Choose `Doris` as the data source, `otel` as the database, and `otel_traces` as the table. Click the **Find Traces** button to fetch the most recent 50 trace records they will be displayed as a chart at the top and a list below. You can experiment with the Service, Operation, Tags, and Duration filters on the left, and try different sort options below the trace chart.
![Trace list](https://cdnd.selectdb.com/images/upload/dogstack/quickstart_traces.png)
Click a specific trace to view its waterfall visualization. Inside the waterfall view, use the **Span Filter** to further filter spans within the trace.
![Trace waterfall](https://cdnd.selectdb.com/images/upload/dogstack/quickstart_waterfall.png)
## Dashboards
Click **Dashboards** in the left-side menu, then click **Doris Demo**, and finally click **Collector Self-Monitoring**. You will see the demo dashboard below, which shows host metrics of the OpenTelemetry Collector itself.
![Demo dashboard](https://cdnd.selectdb.com/images/upload/dogstack/quickstart_dashboard.png)
## Alerting
You can create alert rules based on SQL queries against Doris. Specify the alert condition parameters such as the **Reduce** function and the **Threshold**.
![Alert rule](https://cdnd.selectdb.com/images/upload/dogstack/quickstart_alert.png)