Skip to content

Commit b4c2ada

Browse files
committed
Fixes, videos
1 parent 2f42b4a commit b4c2ada

12 files changed

+90
-75
lines changed
420 KB
Binary file not shown.

doc-assets/videos/create-dataset.mp4

469 KB
Binary file not shown.

doc-assets/videos/create-monitor.mp4

721 KB
Binary file not shown.

doc-assets/videos/create-notifier.mp4

451 KB
Binary file not shown.

doc-assets/videos/dashboards-tab.mp4

698 KB
Binary file not shown.

doc-assets/videos/datasets-tab.mp4

742 KB
Binary file not shown.

doc-assets/videos/explore-tab.mp4

575 KB
Binary file not shown.

doc-assets/videos/stream-tab.mp4

678 KB
Binary file not shown.

docs.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@
2525
"pages": [
2626
"getting-started-guide/explore-axiom-playground",
2727
"getting-started-guide/quickstart-using-sample-data",
28-
"getting-started-guide/integrating-axiom",
28+
"getting-started-guide/integrate-axiom",
2929
"getting-started-guide/get-started-example-app",
3030
"getting-started-guide/example-projects"
3131
]

getting-started-guide/explore-axiom-playground.mdx

Lines changed: 26 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -7,57 +7,53 @@ Axiom offers access to your event data without compromises: all your data, all t
77

88
This page explains how to try out Axiom without registration with the [Axiom Playground](https://play.axiom.co/). It walks you through an example where you run a website and you want to keep an overview of the HTTP requests to this site with Axiom.
99

10-
To try out Axiom with sample data but without integrating it into your system, see [Getting started with Axiom](/getting-started-guide/getting-started).
10+
To try out Axiom with sample data but without integrating it into your system, see [Quickstart using sample data](getting-started-guide/quickstart-using-sample-data).
1111

12-
To start integrating Axiom into your system, see [Start integrating Axiom into your system](/getting-started-guide/integrate-axiom).
12+
To start integrating Axiom into your system, see [Integrate Axiom into your system](/getting-started-guide/integrate-axiom).
1313

1414
## 1. Display stream of incoming data
1515

1616
1. Go to the [Axiom Playground](https://play.axiom.co/).
17-
2. Click the **Stream** tab on the top of the page.
18-
3. Click **sample-http-logs** in the list.
17+
1. Click the **Stream** tab on the top of the page.
18+
1. Click **sample-http-logs** in the list.
1919

20-
<RunInPlayGround
21-
href="https://play.axiom.co/axiom-play-qf1k/stream/sample-http-logs"
22-
target="_blank"
23-
rel="noopener noreferrer"
24-
/>
20+
[Run in Playground](https://play.axiom.co/axiom-play-qf1k/stream/sample-http-logs)
2521

2622
You see the data that Axiom receives realtime. In this example, this page displays the HTTP requests to your imaginary website.
2723

2824
## 2. Query data
2925

30-
1. Click the **Datasets** tab on the top of the page, and then click **sample-http-logs** in the list. This tab enables you to query your data with a visual query editor.
31-
2. In the **Filter** section, click **+**.
32-
3. Write **status == "500"**, and then press **Enter**.
33-
4. Click **Run query**.
26+
1. Click the **Query** tab on the top of the page, and then click **Builder** in the top left. This enables you to query your data with a visual query builder.
27+
1. In the **Dataset** section, select **sample-http-logs** from the list of datasets.
28+
1. In the **Where** section, click **+**.
29+
1. Write **status == "500"**, and then press **Enter**.
30+
1. Click **Run**.
3431

35-
You see all the HTTP requests with the status **500**. This is important to know because this status indicates an internal server error, meaning that the server has encountered a situation that it can't handle.
32+
You see all the HTTP requests with the status 500. This is important to know because this status indicates an internal server error, meaning that the server has encountered a situation that it cant handle.
3633

37-
<RunInPlayGround
38-
href="https://play.axiom.co/axiom-play-qf1k/datasets/sample-http-logs"
39-
target="_blank"
40-
rel="noopener noreferrer"
41-
/>
34+
[Run in Playground](https://play.axiom.co/axiom-play-qf1k/query?initForm=%7B%22apl%22%3A%22%5B'sample-http-logs'%5D%20%7C%20where%20status%20%3D%3D%20'500'%22%7D)
4235

43-
## 3. Run an advanced query
36+
## 3. Run an APL query
4437

45-
1. Click the **Explore** tab on the top of the page, and then click **sample-http-logs** in the list. This tab enables you to query your data using the Axiom Processing Language (APL). For more information, see [Introduction to APL](/apl/introduction).
46-
2. In the text field, enter the following:
47-
```apl copy
38+
1. Click the **Query** tab on the top of the page, and then click **APL** in the top left. This enables you to query your data with the Axiom Processing Language (APL). For more information, see [Introduction to APL](/apl/introduction).
39+
1. In the text field, enter the following:
40+
```kusto
4841
['sample-http-logs']
4942
| summarize count() by bin_auto(_time), status
5043
```
51-
3. Click **Run query**.
44+
1. Click **Run**.
5245

5346
You see the number of HTTP requests of each status over time.
5447

55-
<RunInPlayGround
56-
href="https://play.axiom.co/axiom-play-qf1k/explorer?initForm=%7B%22apl%22%3A%22%5B'sample-http-logs'%5D%5Cn%7C%20summarize%20count()%20by%20bin_auto(_time)%2C%20status%22%2C%22queryOptions%22%3A%7B%22quickRange%22%3A%2230m%22%7D%7D"
57-
target="_blank"
58-
rel="noopener noreferrer"
59-
/>
48+
[Run in Playground](https://play.axiom.co/axiom-play-qf1k/query?initForm=%7B%22apl%22%3A%22%5B'sample-http-logs'%5D%20%7C%20summarize%20count()%20by%20bin_auto(_time)%2C%20status%22%7D)
6049

61-
## What's next
50+
## 4. Visualize data
51+
52+
1. Click the **Dashboards** tab on the top of the page.
53+
1. Click **Http logs** in the list.
54+
55+
You see a dashboard that displays important information about the HTTP requests to the website.
56+
57+
## What’s next
6258

6359
To try out Axiom with sample data but without integrating it into your system, see [Getting started with Axiom](/getting-started-guide/getting-started).

getting-started-guide/integrate-axiom.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: 'Integrate Axiom into your system'
33
excerpt: 'This page explains how to start integrating Axiom into your system.'
4+
sidebarTitle: Integrate Axiom
45
---
56

67
Axiom enables you to make the most of your event data without compromises: all your data, all the time, for all possible needs. Say goodbye to data sampling, waiting times, and hefty fees.

getting-started-guide/quickstart-using-sample-data.mdx

Lines changed: 62 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -9,82 +9,100 @@ This page explains how to try out Axiom with sample data. It walks you through a
99

1010
By following this page, you will:
1111

12-
1. Send sample data to Axiom.
13-
2. Analyze the data.
14-
3. Visualize the data by creating a simple dashboard.
15-
4. Set up a monitor that alerts you about internal server errors.
12+
1. Explore the structure of sample data.
13+
1. Display stream of incoming data.
14+
1. Analyze the data.
15+
1. Visualize the data by creating a simple dashboard.
16+
1. Set up a monitor that alerts you about internal server errors.
1617

1718
To try out Axiom without registration, go to the [Axiom Playground](https://play.axiom.co/). For more information on how to navigate the Playground, see [Try out Axiom without registration](/getting-started-guide/explore-axiom-playground).
1819

19-
To start integrating Axiom into your system, see [Start integrating Axiom into your system](/getting-started-guide/integrate-axiom).
20+
To start integrating Axiom into your system, see [Integrate Axiom into your system](/getting-started-guide/integrate-axiom).
2021

21-
## 1. Send data to Axiom
22+
## 1. Explore sample data
2223

2324
1. [Sign up for an Axiom account](https://app.axiom.co/register). All you need is an email address.
24-
2. Click **Create dataset**.
25-
3. Name your dataset **sample-http-logs**, and then click **Add**.
26-
4. Click **Send sample data to this dataset**.
25+
1. Click the **Datasets** tab on the top of the page.
26+
1. In the list of datasets, click `sample-http-logs`.
2727

28-
This creates a dataset in your account. In Axiom, an individual piece of data is an event, and a dataset is a collection of similar events. In this example, an event is an HTTP request to your website, and the dataset holds incoming data about all these HTTP requests.
28+
This displays the fields in the sample dataset `sample-http-logs`. In Axiom, an individual piece of data is an event, and a dataset is a collection of similar events. In this example, an event is an HTTP request to your website, and the dataset holds incoming data about all these HTTP requests.
2929

30-
## 2. Analyze data
31-
32-
### Display stream of incoming data
30+
## 2. Display stream of incoming data
3331

3432
1. Click the **Stream** tab on the top of the page.
3533
2. Click **sample-http-logs** in the list.
3634

3735
You see the data that Axiom receives realtime. In this example, this page displays the HTTP requests to your imaginary website.
3836

37+
## 3. Analyze data
38+
3939
### Query data
4040

41-
1. Click the **Datasets** tab on the top of the page, and then click **sample-http-logs**. This tab enables you to query your data with a visual query editor.
42-
2. In the **Filter** section, click **+**.
43-
3. Write **status == "500"**, and then press **Enter**.
44-
4. Click **Run query**.
41+
1. Click the **Query** tab on the top of the page, and then click **Builder** in the top left. This enables you to query your data with a visual query builder.
42+
1. In the **Dataset** section, select **sample-http-logs** from the list of datasets.
43+
1. In the **Where** section, click **+**.
44+
1. Write **status == "500"**, and then press **Enter**.
45+
1. Click **Run**.
4546

46-
You see all the HTTP requests with the status **500**. This is important to know because this status indicates an internal server error, meaning that the server has encountered a situation that it can't handle.
47+
You see all the HTTP requests with the status 500. This is important to know because this status indicates an internal server error, meaning that the server has encountered a situation that it cant handle.
4748

48-
### Run an advanced query
49+
### Run an APL query
4950

50-
1. Click the **Explore** tab on the top of the page, and then click your dataset. This tab enables you to query your data using the Axiom Processing Language (APL). For more information, see [Introduction to APL](/apl/introduction).
51-
2. In the text field, enter the following:
52-
```apl copy
51+
1. Click the **Query** tab on the top of the page, and then click **APL** in the top left. This enables you to query your data with the Axiom Processing Language (APL). For more information, see [Introduction to APL](/apl/introduction).
52+
1. In the text field, enter the following:
53+
```kusto
5354
['sample-http-logs']
5455
| summarize count() by bin_auto(_time), status
5556
```
56-
3. Click **Run query**.
57+
1. Click **Run**.
5758

5859
You see the number of HTTP requests of each status over time.
5960

60-
## 3. Visualize data
61+
## 4. Visualize data
62+
63+
1. Click the **Dashboards** tab on the top of the page.
64+
1. Click **Http logs** in the list.
65+
66+
You see a dashboard that displays important information about the HTTP requests to the website.
67+
68+
## 5. Create new dashboard
6169

6270
1. Click the **Dashboards** tab on the top of the page, and then click **New dashboard** on the right.
63-
2. Name the dashboard and click **Create**.
64-
3. Click **Add a chart**, and then click **Simple Query Builder**.
65-
4. In **Dataset**, select **sample-http-logs**.
66-
5. To the right of **Group by**, click **+**, and then select **status**.
67-
6. Click **Save**.
71+
1. Name the dashboard and click **Create**.
72+
1. Click **Add a chart**, and then click **Timeseries**.
73+
1. In the **Dataset** section, select **sample-http-logs**.
74+
1. In the **Summarize** section, click **no group** to the right of **by**, and then select **status**.
75+
1. Click **Save**.
6876

6977
You created a simple dashboard that displays the number of HTTP requests of each status over time.
7078

71-
## 4. Monitor data for issues
72-
73-
1. Click the **Monitors** tab on the top of the page, and then click **Manage notifiers** on the right.
74-
2. Click **New notifier** on the top right.
75-
3. In **Name**, enter **Internal server error notifier**.
76-
4. In **Users**, enter your email address, and then click **+** on the right.
77-
5. Click **Create**, and then click **Done**.
78-
6. Click **New monitor**.
79-
7. Click **Add notifier**, and then select **Internal server error notifier**.
80-
8. click **Simple Query Builder**.
81-
9. In **Dataset**, select **sample-http-logs**.
82-
10. In the **Filter** section, click **+**.
83-
11. Write **status == "500"**, and then press **Enter**.
84-
12. Click **Create**.
79+
## 6. Monitor data for issues
80+
81+
### Create notifier
82+
83+
1. Click the **Monitors** tab on the top of the page.
84+
1. In the top left, click **Notifiers**, and then click **New notifier** on the top right.
85+
1. In **Name**, enter **Internal server error notifier**.
86+
1. In **Users**, enter your email address, and then click **+** on the right.
87+
1. Click **Create**.
88+
89+
### Create monitor
90+
91+
1. In the top left, click **Monitors**, and then click **New monitor** on the top right.
92+
1. Click **Threshold monitor**.
93+
1. In **Check options**, enter `1000` as the value.
94+
1. Click **+ Add notifier**, and then select **Email: Internal server error notifier**.
95+
1. Click **Builder**.
96+
1. In the **APL** section, enter the following:
97+
```kusto
98+
['sample-http-logs']
99+
| where status == "500"
100+
| summarize count() by bin_auto(_time)
101+
```
102+
1. Click **Create**.
85103

86104
You created a monitor that automatically sends a notification to your email address if the HTTP requests with the status **500** is higher than 1,000 in ten minutes.
87105

88106
## What's next
89107

90-
To start integrating Axiom into your system, see [Start integrating Axiom into your system](/getting-started-guide/integrate-axiom).
108+
To start integrating Axiom into your system, see [Integrate Axiom into your system](/getting-started-guide/integrate-axiom).

0 commit comments

Comments
 (0)