# Monitorização Externa

## Visão geral

O endpoint de monitorização da sua instância RADIUSaaS permite-lhe realizar as seguintes tarefas na sua própria solução de monitorização de terceiros:

* Monitorizar o tempo de atividade dos seus endpoints RadSec.
* Monitorizar o tempo de atividade dos seus proxies RADIUS.
* Monitorizar a expiração do seu Certificado de Servidor RADIUS e da respetiva CA emissora.

Se for viável na sua solução de monitorização, podem ser criadas agregações e métricas em torno desses monitores para acionar alertas automatizados. 

## Definição do Esquema da API

Consulte a [documentação da API](/pt/outro/rest-api.md#api-reference) no seu RADIUSaaS Admin Portal para obter informações detalhadas sobre o esquema do `/status` endpoint.

## Exemplos da API

{% hint style="info" %}
Tenha em atenção que não podemos fornecer suporte para soluções de monitorização de terceiros e que terá de trazer a sua própria experiência para além do âmbito deste artigo. 
{% endhint %}

{% stepper %}
{% step %}

### Crie um Token de Acesso conforme descrito [aqui](/pt/portal-de-administracao/settings/permissions.md#access-tokens).

{% endstep %}

{% step %}

### Obter Dados

Para obter dados do endpoint da API, autentique os seus pedidos utilizando o token de acesso criado anteriormente:

{% tabs %}
{% tab title="PowerShell" %}

1. **Armazenar o Token de Acesso**

Armazene o token de acesso numa variável do PowerShell para fácil referência. Substitua `your_access_token` pelo token real.

```powershell
$accessToken = "your_access_token"
```

2. **Fazer o Pedido à API**

Utilize o `Invoke-RestMethod` do PowerShell para enviar um pedido à API pretendida. Certifique-se de que inclui o token de acesso no cabeçalho do pedido.

```powershell
$url = "https://contoso.radius-as-a-service.com/api/status"
$headers = @{
    Authorization = "Bearer $accessToken"
}
$response = Invoke-RestMethod -Uri $url -Headers $headers -Method Get
```

{% endtab %}

{% tab title="cURL" %}

```
curl -i https://contoso.radius-as-a-service.com/api/status \ -H "Authorization: Bearer [your_access_token]"
```

{% endtab %}

{% tab title="Python" %}

```
import requests

url = "https://contoso.radius-as-a-service.com/api/status"
headers = {
    "Authorization": "Bearer your_access_token"
}

response = requests.get(url, headers=headers)

print(response.status_code)
print(response.text)
```

{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### Processar os dados de acordo com as suas necessidades

#### Exemplo 1 - Mostrar informações sobre os servidores RadSec:

```
$response.radsecservers

cluster_name                     : eu1
ip                               : 20.113.8.151
name                             : radius-server-contoso-main
radius-server-contoso-main-state : True
state                            : True
```

#### Exemplo 2 - Mostrar informações sobre os proxies RADIUS:

```
$response.proxies

ip                                       : 142.93.161.44
location                                 : Europa (Frankfurt)
name                                     : radius-proxy-contoso-142.93.161.44
radius-proxy-contoso-142.93.161.44-state : True
state                                    : True

ip                                     : 209.38.81.0
location                               : Austrália (Sydney)
name                                   : radius-proxy-contoso-209.38.81.0
radius-proxy-contoso-209.38.81.0-state : True
state                                  : True
```

#### Exemplo 3 - Mostrar informações do certificado:

```
$response.certificates | Format-List

contoso-certificate--Proxycertificate-state : True
name                                        : contoso-certificate--Proxycertificate
state                                       : True
validity_days_left                          : 2570

contoso-certificate-Customer-CA-state : True
name                                  : contoso-certificate-Customer-CA
state                                 : True
validity_days_left                    : 6900
```

{% hint style="info" %}
Tenha em atenção que os **certificados** serão **verificados a cada 10 horas,** e o **data** é **armazenado em cache durante 60 segundos**. Consequentemente, após renovar um certificado expirado, pode demorar várias horas até que o estado seja atualizado.
{% endhint %}
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.radiusaas.com/pt/outro/rest-api/monitorizacao-externa.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.