Skip to main content

Tesmon API (0.0.0)

Download OpenAPI specification:Download

Introduction

This API is documented in OpenAPI format. In addition to standard OpenAPI syntax we use a few vendor extensions.

Authentication

Tesmon offers below forms of authentication:

  • API Key

api_key

For this API docs, you can use the api key SIGNOZ-API-KEY to access data.

Security Scheme Type: API Key
Header parameter name: SIGNOZ-API-KEY

alerts

Alerts API

Add a alert rule to the system

Add a alert rule to the system

header Parameters
SIGNOZ-API-KEY
required
string
Example: <TOKEN>
Request Body schema: application/json
required

Alert object that needs to be added to the system

alert
required
string

Name of the alert

required
AlertType (string)

Type of the alert

description
string

Description of the alert

required
RuleType (string)

Type of the rule

evalWindow
string

Evaluation time window (ex - (now-15m, now)) for the alert in parseable format ("15m", "30m" "1h" etc.). Default is 5m.

frequency
string

Run frequency of the alert in parseable format ("15m", "30m" "1h" etc.). Default is 1m.

required
object

Condition criteria for the alert.

object

Labels kv map for the alert

object

Annotations kv map for the alert

disabled
boolean

Whether the alert is disabled or not

source
string

Source of the alert where it is created from.

preferredChannels
Array of strings

Preferred channels for the alert. If not specified, all the channels will be used. Use the alert channel for this.

Responses

Request samples

Content type
application/json
{
  • "alert": "string",
  • "alertType": "LOGS_BASED_ALERT",
  • "description": "string",
  • "ruleType": "threshold_rule",
  • "evalWindow": "string",
  • "frequency": "string",
  • "condition": {
    },
  • "labels": {
    },
  • "annotations": {
    },
  • "disabled": true,
  • "source": "string",
  • "preferredChannels": [
    ]
}

Get all alert rules

header Parameters
SIGNOZ-API-KEY
required
string
Example: <TOKEN>

Responses

Response samples

Content type
application/json
{
  • "alert": "string",
  • "alertType": "LOGS_BASED_ALERT",
  • "description": "string",
  • "ruleType": "threshold_rule",
  • "evalWindow": "string",
  • "frequency": "string",
  • "condition": {
    },
  • "labels": {
    },
  • "annotations": {
    },
  • "disabled": true,
  • "source": "string",
  • "preferredChannels": [
    ]
}

Find alert rule by ID

Returns a single alert rule

path Parameters
id
required
integer <int64>

ID of alert rule to return

header Parameters
SIGNOZ-API-KEY
required
string
Example: <TOKEN>

Responses

Response samples

Content type
application/json
{
  • "alert": "string",
  • "alertType": "LOGS_BASED_ALERT",
  • "description": "string",
  • "ruleType": "threshold_rule",
  • "evalWindow": "string",
  • "frequency": "string",
  • "condition": {
    },
  • "labels": {
    },
  • "annotations": {
    },
  • "disabled": true,
  • "source": "string",
  • "preferredChannels": [
    ]
}

Update an existing alert rule

path Parameters
id
required
integer <int64>

ID of alert rule to update

header Parameters
SIGNOZ-API-KEY
required
string
Example: <TOKEN>
Request Body schema: application/json
required

Alert object that needs to be added to the system

alert
required
string

Name of the alert

required
AlertType (string)

Type of the alert

description
string

Description of the alert

required
RuleType (string)

Type of the rule

evalWindow
string

Evaluation time window (ex - (now-15m, now)) for the alert in parseable format ("15m", "30m" "1h" etc.). Default is 5m.

frequency
string

Run frequency of the alert in parseable format ("15m", "30m" "1h" etc.). Default is 1m.

required
object

Condition criteria for the alert.

object

Labels kv map for the alert

object

Annotations kv map for the alert

disabled
boolean

Whether the alert is disabled or not

source
string

Source of the alert where it is created from.

preferredChannels
Array of strings

Preferred channels for the alert. If not specified, all the channels will be used. Use the alert channel for this.

Responses

Request samples

Content type
application/json
{
  • "alert": "string",
  • "alertType": "LOGS_BASED_ALERT",
  • "description": "string",
  • "ruleType": "threshold_rule",
  • "evalWindow": "string",
  • "frequency": "string",
  • "condition": {
    },
  • "labels": {
    },
  • "annotations": {
    },
  • "disabled": true,
  • "source": "string",
  • "preferredChannels": [
    ]
}

Deletes a alert rule

path Parameters
id
required
integer <int64>

Alert rule id to delete

header Parameters
SIGNOZ-API-KEY
required
string
Example: <TOKEN>

Responses

dashboards

Access to dashboards

Add a dashboard to the system

Add a dashboard to the system

header Parameters
SIGNOZ-API-KEY
required
string
Example: <TOKEN>
Request Body schema: application/json
required

Dashboard object that needs to be added to the system

title
required
string

Title of the dashboard

description
string

Description of the dashboard

tags
Array of strings

Tags for the dashboard

required
Array of objects

Layout for the dashboard

object

Variables for the dashboard

required
Array of objects (Widget)

Widgets for the dashboard

Responses

Request samples

Content type
application/json
{
  • "title": "string",
  • "description": "string",
  • "tags": [
    ],
  • "layout": [
    ],
  • "variables": {
    },
  • "widgets": [
    ]
}

Get all dashboards

header Parameters
SIGNOZ-API-KEY
required
string
Example: <TOKEN>

Responses

Response samples

Content type
application/json
{
  • "title": "string",
  • "description": "string",
  • "tags": [
    ],
  • "layout": [
    ],
  • "variables": {
    },
  • "widgets": [
    ]
}

Find dashboard by UUID

Returns a single dashboard

path Parameters
id
required
string

ID of dashboard to return

header Parameters
SIGNOZ-API-KEY
required
string
Example: <TOKEN>

Responses

Response samples

Content type
application/json
{
  • "title": "string",
  • "description": "string",
  • "tags": [
    ],
  • "layout": [
    ],
  • "variables": {
    },
  • "widgets": [
    ]
}

Update an existing dashboard

path Parameters
id
required
string

ID of dashboard to update

header Parameters
SIGNOZ-API-KEY
required
string
Example: <TOKEN>
Request Body schema: application/json
required

Dashboard object that needs to be added to the system

title
required
string

Title of the dashboard

description
string

Description of the dashboard

tags
Array of strings

Tags for the dashboard

required
Array of objects

Layout for the dashboard

object

Variables for the dashboard

required
Array of objects (Widget)

Widgets for the dashboard

Responses

Request samples

Content type
application/json
{
  • "title": "string",
  • "description": "string",
  • "tags": [
    ],
  • "layout": [
    ],
  • "variables": {
    },
  • "widgets": [
    ]
}

Deletes a alert rule

path Parameters
id
required
string

Alert rule id to delete

header Parameters
SIGNOZ-API-KEY
required
string
Example: <TOKEN>

Responses

The Alerts Model

alert
required
string

Name of the alert

required
AlertType (string)

Type of the alert

description
string

Description of the alert

required
RuleType (string)

Type of the rule

evalWindow
string

Evaluation time window (ex - (now-15m, now)) for the alert in parseable format ("15m", "30m" "1h" etc.). Default is 5m.

frequency
string

Run frequency of the alert in parseable format ("15m", "30m" "1h" etc.). Default is 1m.

required
object

Condition criteria for the alert.

object

Labels kv map for the alert

object

Annotations kv map for the alert

disabled
boolean

Whether the alert is disabled or not

source
string

Source of the alert where it is created from.

preferredChannels
Array of strings

Preferred channels for the alert. If not specified, all the channels will be used. Use the alert channel for this.

{
  • "alert": "string",
  • "alertType": "LOGS_BASED_ALERT",
  • "description": "string",
  • "ruleType": "threshold_rule",
  • "evalWindow": "string",
  • "frequency": "string",
  • "condition": {
    },
  • "labels": {
    },
  • "annotations": {
    },
  • "disabled": true,
  • "source": "string",
  • "preferredChannels": [
    ]
}

The Dashboards Model

title
required
string

Title of the dashboard

description
string

Description of the dashboard

tags
Array of strings

Tags for the dashboard

required
Array of objects

Layout for the dashboard

object

Variables for the dashboard

required
Array of objects (Widget)

Widgets for the dashboard

{
  • "title": "string",
  • "description": "string",
  • "tags": [
    ],
  • "layout": [
    ],
  • "variables": {
    },
  • "widgets": [
    ]
}