Skip to main content

Using on the Nobl9 Web

Reading time: 0 minute(s) (0 words)

You can add user annotations in the SLO details page on any chart.

For this, do the following:

  1. Click the required area on the chart and enter your note.
    Markdown is supported
    Up to 1000 characters per note.

  2. Optional: Modify start and end time for your annotation.
    When skipped, both dates are set to startTime.

    adding user annotation
    Adding user annotation
  3. Once done, click ADD ANNOTATION
    As a result, your added annotation is displayed on the objective's charts in SLO details.

    active user annotation
    User annotation
Layering annotations

Annotations can overlap in time.
Read more about annotation visuals.

ActionSteps
View annotationClick the annotation's icon above the chart.
Delete annotation
  1. Open the required annotation.
  2. Hover the mouse over the annotation. Click .
  3. Click DELETE to confirm.
Show and hide annotations on SLO details
  1. Click next to your SLO name.
  2. Select Annotations.
  3. Turn ON or OFF the required annotation type
Show and hide annotations in SLO History reports
  1. Click Annotations in the report header.
  2. Turn ON or OFF the required annotation type.
  3. Click Apply.

Markdown features

In the Nobl9 Web application, you can format annotation descriptions using Markdown. This allows you to add headings, bold or italic text, links, lists, and more, making your annotations easier to read and visually appealing.

Annotations formatted in Markdown are rendered as HTML in the Nobl9 Web interface. However, when retrieved through the Nobl9 Annotations API or sloctl, they remain in their original Markdown format.

For example:

  • If you enter **bold text**, it will be displayed as bold text within your annotation description.
  • The same annotation, when retrieved via API or sloctl, will appear as **bold text**.

Below are some examples of Markdown syntax and how it is rendered in the Nobl9 Web interface.


Headings

Syntax:

    # First-level heading
## Second-level heading
### Third-level heading

Rendered:

First-level heading

Second-level heading

Third-level heading


Bold text

Syntax:

**this text is bold**

Rendered:
this text is bold


Italicized text

Syntax:

*this text is italicized* and _this text is italicized_

Rendered:
this text is italicized and this text is italicized


Bold italicized text

Syntax:

**_this text is bold italicized_**

Rendered:
this text is bold italicized


Links

Syntax:

[Nobl9 documentation](https://docs.nobl9.com/)

Rendered:
Nobl9 documentation


Ordered lists

Syntax:

    1. Item 1
2. Item 2
3. Item 3
1. Item 3a
2. Item 3b

Rendered:

  1. Item 1
  2. Item 2
  3. Item 3
    1. Item 3i
    2. Item 3ii

Unordered lists

Syntax:

    * Item 1
* Item 2
* Item 3
* Item 3a
* Item 3b

Rendered:

  • Item 1
  • Item 2
  • Item 3
    • Item 3a
    • Item 3b

Blockquotes

Syntax:

> My blockquote
> > My nested blockquote

Rendered:

My blockquote

My nested blockquote


Inline code

Syntax:

`this is code`

Rendered:
this is code


Fenced code block

Syntax:

```json
{
"my-annotation": {
"name": "Tia Key",
"event": "deployment"
}
}

```

Rendered:

{
"my-annotation": {
"name": "Tia Key",
"event": "deployment"
}
}

Tables

Syntax:

|  Column 1 | Column 2  |  Column 3 |
|-----------|-----------|-----------|
| Cell text | Cell text | Cell text |

Rendered:

Column 1Column 2Column 3
Cell textCell textCell text
For a more in-depth look, consult additional resources: