# Externe Überwachung

## Übersicht

Der Monitoring-Endpunkt Ihrer RADIUSaaS-Instanz ermöglicht Ihnen, die folgenden Aufgaben in Ihrer eigenen Monitoring-Lösung eines Drittanbieters durchzuführen:

* Überwachen Sie die Verfügbarkeit Ihrer RadSec-Endpunkte.
* Überwachen Sie die Verfügbarkeit Ihrer RADIUS-Proxys.
* Überwachen Sie das Ablaufdatum Ihres RADIUS-Serverzertifikats und der ausstellenden CA.

Falls in Ihrer Monitoring-Lösung möglich, können Aggregation und Metriken auf Basis dieser Monitore erstellt werden, um automatisierte Warnungen auszulösen. 

## API-Schema-Definition

Bitte beachten Sie die [API-Dokumentation](/de/andere/rest-api.md#api-reference) in Ihrem RADIUSaaS Admin Portal für detaillierte Informationen zum Schema des `/status` Endpunkts.

## API-Beispiele

{% hint style="info" %}
Bitte beachten Sie, dass wir keinen Support für Monitoring-Lösungen von Drittanbietern anbieten können und Sie über das in diesem Artikel beschriebene Maß hinaus Ihr eigenes Fachwissen einbringen müssen. 
{% endhint %}

{% stepper %}
{% step %}

### Erstellen Sie einen Zugriffstoken wie beschrieben [hier](/de/admin-portal/settings/permissions.md#access-tokens).

{% endstep %}

{% step %}

### Daten abrufen

Um Daten vom API-Endpunkt abzurufen, authentifizieren Sie Ihre Anfragen mit dem zuvor erstellten Zugriffstoken:

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

1. **Speichern Sie den Zugriffstoken**

Speichern Sie den Zugriffstoken in einer PowerShell-Variable zur einfachen Referenz. Ersetzen Sie `your_access_token` durch das tatsächliche Token.

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

2. **Die API-Anfrage stellen**

Verwenden Sie PowerShells `Invoke-RestMethod` um eine Anfrage an die gewünschte API zu senden. Stellen Sie sicher, dass Sie den Zugriffstoken im Anforderungsheader einschließen.

```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 %}

### Verarbeiten Sie die Daten nach Ihren Bedürfnissen

#### Beispiel 1 - Informationen über die RadSec-Server anzeigen:

```
$response.radsecservers

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

#### Beispiel 2 - Informationen über die RADIUS-Proxys anzeigen:

```
$response.proxies

ip                                       : 142.93.161.44
location                                 : Europe (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                               : Australia (Sydney)
name                                   : radius-proxy-contoso-209.38.81.0
radius-proxy-contoso-209.38.81.0-state : True
state                                  : True
```

#### Beispiel 3 - Zertifikatsinformationen anzeigen:

```
$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" %}
Bitte beachten Sie, dass die **Zertifikate** werden **alle 10 Stunden überprüft,** und der **data** wird **60 Sekunden lang zwischengespeichert**. Folglich kann es nach der Erneuerung eines abgelaufenen Zertifikats mehrere Stunden dauern, bis der Status aktualisiert wird.
{% 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/de/andere/rest-api/externe-uberwachung.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.