

Hinweis zum Ende des Supports: Am 7. Oktober 2026 AWS wird der Support für eingestellt. AWS IoT Greengrass Version 1 Nach dem 7. Oktober 2026 können Sie nicht mehr auf die Ressourcen zugreifen. AWS IoT Greengrass V1 Weitere Informationen finden Sie unter [Migrieren von AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# ServiceNow MetricBase Integrationsanschluss
<a name="servicenow-connector"></a>

**Warnung**  <a name="connectors-extended-life-phase-warning"></a>
Dieser Connector befindet sich in der *Phase mit verlängerter Lebensdauer* und veröffentlicht AWS IoT Greengrass keine Updates, die Funktionen, Verbesserungen vorhandener Funktionen, Sicherheitspatches oder Bugfixes bereitstellen. Weitere Informationen finden Sie unter [AWS IoT Greengrass Version 1 Wartungspolitik](maintenance-policy.md).

Der ServiceNow MetricBase [Integrationskonnektor](connectors.md) veröffentlicht Zeitreihenmetriken von Greengrass-Geräten an ServiceNow MetricBase. Auf diese Weise können Sie Zeitreihendaten aus der Greengrass Core-Umgebung speichern, analysieren und visualisieren und auf lokale Ereignisse reagieren.

Dieser Konnektor empfängt Zeitreihendaten zu einem MQTT-Thema und veröffentlicht die Daten in regelmäßigen Abständen in der ServiceNow API.

Sie können diesen Konnektor zur Unterstützung vieler Szenarien verwenden, darunter z. B.:
+ Erstellen von Schwellenwert-basierten Warnmeldungen und Alarmen basierend auf Zeitreihendaten, die von Greengrass-Geräten gesammelt wurden.
+ Verwenden Sie Zeitdienstdaten von Greengrass-Geräten mit benutzerdefinierten Anwendungen, die auf der ServiceNow Plattform erstellt wurden.

Dieser Konnektor hat die folgenden Versionen.


| Version | ARN | 
| --- | --- | 
| 4 | `arn:aws:greengrass:{{region}}::/connectors/ServiceNowMetricBaseIntegration/versions/4` | 
| 3 | `arn:aws:greengrass:{{region}}::/connectors/ServiceNowMetricBaseIntegration/versions/3` | 
| 2 | `arn:aws:greengrass:{{region}}::/connectors/ServiceNowMetricBaseIntegration/versions/2` | 
| 1 | `arn:aws:greengrass:{{region}}::/connectors/ServiceNowMetricBaseIntegration/versions/1` | 

Informationen über Versionsänderungen finden Sie im [Änderungsprotokoll](#servicenow-connector-changelog).

## Voraussetzungen
<a name="servicenow-connector-req"></a>

Dieser Konnektor hat die folgenden Anforderungen:

------
#### [ Version 3 - 4 ]
+ <a name="conn-req-ggc-v1.9.3-secrets"></a>AWS IoT Greengrass Kernsoftware v1.9.3 oder höher. AWS IoT Greengrass muss so konfiguriert sein, dass es lokale Geheimnisse unterstützt, wie in [Secrets Requirements](secrets.md#secrets-reqs) beschrieben.
**Anmerkung**  
Diese Anforderung beinhaltet die Gewährung des Zugriffs auf Ihre Secrets Manager Manager-Geheimnisse. Wenn Sie die standardmäßige Greengrass-Servicerolle verwenden, ist Greengrass berechtigt, die Werte von Geheimnissen abzurufen, deren Namen mit *greengrass* - beginnen.
+ <a name="conn-req-py-3.7-and-3.8"></a>[Python-Version](https://www.python.org/) 3.7 oder 3.8 wurde auf dem Core-Gerät installiert und zur Umgebungsvariablen PATH hinzugefügt.
**Anmerkung**  <a name="use-runtime-py3.8"></a>
Um Python 3.8 zu verwenden, führen Sie den folgenden Befehl aus, um einen symbolischen Link vom standardmäßigen Python 3.7-Installationsordner zu den installierten Python 3.8-Binärdateien zu erstellen.  

  ```
  sudo ln -s {{path-to-python-3.8}}/python3.8 /usr/bin/python3.7
  ```
Dadurch wird Ihr Gerät so konfiguriert, dass es die Python-Anforderung für AWS IoT Greengrass erfüllt.
+ <a name="conn-servicenow-req-servicenow-account"></a>Ein ServiceNow Konto mit einem aktivierten Abonnement für MetricBase. Darüber hinaus muss im Konto eine Metrik und eine metrische Tabelle angelegt werden. Weitere Informationen finden Sie [MetricBase](https://docs.servicenow.com/bundle/london-servicenow-platform/page/administer/metricbase/concept/metricbase.html)in der ServiceNow Dokumentation.
+ <a name="conn-servicenow-req-secret"></a>Ein geheimer Texttyp AWS Secrets Manager , in dem der Benutzername und das Passwort für die Anmeldung bei Ihrer ServiceNow Instance mit Standardauthentifizierung gespeichert werden. Das Secret muss "Benutzer-" und "Passwort-"Schlüssel mit entsprechenden Werten enthalten. Weitere Informationen finden Sie unter [Creating a Basic Secret](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) im *AWS Secrets Manager Benutzerhandbuch*.
+ Eine geheime Ressource in der Greengrass-Gruppe, die auf das Secrets Manager Manager-Geheimnis verweist. Weitere Informationen finden Sie unter [Verteilen Sie Geheimnisse auf AWS IoT Greengrass core](secrets.md).

------
#### [ Versions 1 - 2 ]
+ <a name="conn-req-ggc-v1.7.0-secrets"></a>AWS IoT Greengrass Kernsoftware v1.7 oder höher. AWS IoT Greengrass muss so konfiguriert sein, dass es lokale Geheimnisse unterstützt, wie in [Secrets Requirements](secrets.md#secrets-reqs) beschrieben.
**Anmerkung**  
Diese Anforderung beinhaltet die Gewährung des Zugriffs auf Ihre Secrets Manager Manager-Geheimnisse. Wenn Sie die standardmäßige Greengrass-Servicerolle verwenden, ist Greengrass berechtigt, die Werte von Geheimnissen abzurufen, deren Namen mit *greengrass* - beginnen.
+ [Python-Version](https://www.python.org/) 2.7 wurde auf dem Core-Gerät installiert und zur Umgebungsvariablen PATH hinzugefügt.
+ <a name="conn-servicenow-req-servicenow-account"></a>Ein ServiceNow Konto mit einem aktivierten Abonnement für MetricBase. Darüber hinaus muss im Konto eine Metrik und eine metrische Tabelle angelegt werden. Weitere Informationen finden Sie [MetricBase](https://docs.servicenow.com/bundle/london-servicenow-platform/page/administer/metricbase/concept/metricbase.html)in der ServiceNow Dokumentation.
+ <a name="conn-servicenow-req-secret"></a>Ein geheimer Texttyp AWS Secrets Manager , in dem der Benutzername und das Passwort für die Anmeldung bei Ihrer ServiceNow Instance mit Standardauthentifizierung gespeichert werden. Das Secret muss "Benutzer-" und "Passwort-"Schlüssel mit entsprechenden Werten enthalten. Weitere Informationen finden Sie unter [Creating a Basic Secret](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) im *AWS Secrets Manager Benutzerhandbuch*.
+ Eine geheime Ressource in der Greengrass-Gruppe, die auf das Secrets Manager Manager-Geheimnis verweist. Weitere Informationen finden Sie unter [Verteilen Sie Geheimnisse auf AWS IoT Greengrass core](secrets.md).

------

## Konnektor-Parameter
<a name="servicenow-connector-param"></a>

Dieser Konnektor stellt die folgenden Parameter bereit:

------
#### [ Version 4 ]

`PublishInterval`  <a name="service-now-PublishInterval"></a>
Die maximale Anzahl von Sekunden, bis zu der zwischen Veröffentlichungsereignissen gewartet werden soll ServiceNow. Der maximale Wert beträgt 900.  
Der Connector veröffentlicht bis zu dem ServiceNow Zeitpunkt, an dem er erreicht `PublishBatchSize` ist oder `PublishInterval` abläuft.  
Anzeigename in der AWS IoT Konsole: **Veröffentlichungsintervall in Sekunden**  
Erforderlich: `true`  
Typ: `string`  
Zulässige Werte: `1 - 900`  
Gültiges Muster: `[1-9]|[1-9]\d|[1-9]\d\d|900`

`PublishBatchSize`  <a name="service-now-PublishBatchSize"></a>
Die maximale Anzahl von Metrikwerten, die gebündelt werden können, bevor sie veröffentlicht werden. ServiceNow  
Der Connector veröffentlicht bis zu dem ServiceNow Zeitpunkt, an dem er erreicht `PublishBatchSize` ist oder `PublishInterval` abläuft.  
Anzeigename in der AWS IoT Konsole: **Batchgröße veröffentlichen**  
Erforderlich: `true`  
Typ: `string`  
Gültiges Muster: `^[0-9]+$`

`InstanceName`  <a name="service-now-InstanceName"></a>
Der Name der Instanz, mit der eine Verbindung hergestellt wurde ServiceNow.  
Anzeigename in der AWS IoT Konsole: **Name der ServiceNow Instanz**  
Erforderlich: `true`  
Typ: `string`  
Gültiges Muster: `.+`

`DefaultTableName`  <a name="service-now-DefaultTableName"></a>
Der Name der Tabelle, die die mit der Zeitreihe `GlideRecord` verknüpfte MetricBase Datenbank enthält. Die Eigenschaft `table` in der Nutzlast der Input-Message kann verwendet werden, um diesen Wert zu überschreiben.  
Anzeigename in der AWS IoT Konsole: **Name der Tabelle, die die Metrik enthalten soll**  
Erforderlich: `true`  
Typ: `string`  
Gültiges Muster: `.+`

`MaxMetricsToRetain`  <a name="service-now-MaxMetricsToRetain"></a>
Die maximale Anzahl der Metriken, die im Speicher gespeichert werden können, bevor sie durch neue Metriken ersetzt werden.  
Diese Begrenzung gilt, wenn keine Verbindung zum Internet besteht und der Konnektor beginnt, die Metriken zu puffern, um sie später zu veröffentlichen. Wenn der Puffer voll ist, werden die ältesten Metriken durch neue Metriken ersetzt.  
Metriken werden nicht gespeichert, wenn der Host-Prozess für den Konnektor unterbrochen wird. Dies kann beispielsweise während der Gruppen-Bereitstellung oder beim Neustart des Geräts geschehen.
Dieser Wert sollte größer als die Batch-Größe und groß genug sein, um Nachrichten basierend auf der Eingangsrate der MQTT-Nachrichten zu halten.  
Anzeigename in der AWS IoT Konsole: **Maximale Anzahl von Metriken, die im Speicher aufbewahrt** werden sollen  
Erforderlich: `true`  
Typ: `string`  
Gültiges Muster: `^[0-9]+$`

`AuthSecretArn`  <a name="service-now-AuthSecretArn"></a>
Das AWS Secrets Manager darin enthaltene Geheimnis speichert den ServiceNow Benutzernamen und das Passwort. Dies muss ein Texttyp Secret sein. Das Secret muss "Benutzer-" und "Passwort-"Schlüssel mit entsprechenden Werten enthalten.  
Anzeigename in der AWS IoT Konsole: **ARN of Auth Secret**  
Erforderlich: `true`  
Typ: `string`  
Gültiges Muster: `arn:aws:secretsmanager:[a-z0-9\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\]+/)*[a-zA-Z0-9/_+=,.@\-]+-[a-zA-Z0-9]+`

`AuthSecretArn-ResourceId`  <a name="service-now-AuthSecretArn-ResourceId"></a>
Die geheime Ressource in der Gruppe, die auf das Secrets Manager Manager-Geheimnis für die ServiceNow Anmeldeinformationen verweist.  
Anzeigename in der AWS IoT Konsole: **Auth-Token-Ressource**  
Erforderlich: `true`  
Typ: `string`  
Gültiges Muster: `.+`

`IsolationMode`  <a name="IsolationMode"></a>
Der [Containerisierungsmodus](connectors.md#connector-containerization) für diesen Konnektor. Die Standardeinstellung ist`GreengrassContainer`, was bedeutet, dass der Konnektor in einer isolierten Laufzeitumgebung innerhalb des AWS IoT Greengrass Containers ausgeführt wird.  
Die Standardeinstellung für Containerisierung für die Gruppe gilt nicht für Konnektoren.
Anzeigename in der AWS IoT Konsole: **Container-Isolationsmodus**  
Erforderlich: `false`  
Typ: `string`  
Gültige Werte: `GreengrassContainer` oder `NoContainer`.  
Gültiges Muster: `^NoContainer$|^GreengrassContainer$`

------
#### [ Version 1 - 3 ]

`PublishInterval`  <a name="service-now-PublishInterval"></a>
Die maximale Anzahl von Sekunden, bis zu der zwischen Veröffentlichungsereignissen gewartet werden soll ServiceNow. Der maximale Wert beträgt 900.  
Der Connector veröffentlicht bis zu dem ServiceNow Zeitpunkt, an dem er erreicht `PublishBatchSize` ist oder `PublishInterval` abläuft.  
Anzeigename in der AWS IoT Konsole: **Veröffentlichungsintervall in Sekunden**  
Erforderlich: `true`  
Typ: `string`  
Zulässige Werte: `1 - 900`  
Gültiges Muster: `[1-9]|[1-9]\d|[1-9]\d\d|900`

`PublishBatchSize`  <a name="service-now-PublishBatchSize"></a>
Die maximale Anzahl von Metrikwerten, die gebündelt werden können, bevor sie veröffentlicht werden. ServiceNow  
Der Connector veröffentlicht bis zu dem ServiceNow Zeitpunkt, an dem er erreicht `PublishBatchSize` ist oder `PublishInterval` abläuft.  
Anzeigename in der AWS IoT Konsole: **Batchgröße veröffentlichen**  
Erforderlich: `true`  
Typ: `string`  
Gültiges Muster: `^[0-9]+$`

`InstanceName`  <a name="service-now-InstanceName"></a>
Der Name der Instanz, mit der eine Verbindung hergestellt wurde ServiceNow.  
Anzeigename in der AWS IoT Konsole: **Name der ServiceNow Instanz**  
Erforderlich: `true`  
Typ: `string`  
Gültiges Muster: `.+`

`DefaultTableName`  <a name="service-now-DefaultTableName"></a>
Der Name der Tabelle, die die mit der Zeitreihe `GlideRecord` verknüpfte MetricBase Datenbank enthält. Die Eigenschaft `table` in der Nutzlast der Input-Message kann verwendet werden, um diesen Wert zu überschreiben.  
Anzeigename in der AWS IoT Konsole: **Name der Tabelle, die die Metrik enthalten soll**  
Erforderlich: `true`  
Typ: `string`  
Gültiges Muster: `.+`

`MaxMetricsToRetain`  <a name="service-now-MaxMetricsToRetain"></a>
Die maximale Anzahl der Metriken, die im Speicher gespeichert werden können, bevor sie durch neue Metriken ersetzt werden.  
Diese Begrenzung gilt, wenn keine Verbindung zum Internet besteht und der Konnektor beginnt, die Metriken zu puffern, um sie später zu veröffentlichen. Wenn der Puffer voll ist, werden die ältesten Metriken durch neue Metriken ersetzt.  
Metriken werden nicht gespeichert, wenn der Host-Prozess für den Konnektor unterbrochen wird. Dies kann beispielsweise während der Gruppen-Bereitstellung oder beim Neustart des Geräts geschehen.
Dieser Wert sollte größer als die Batch-Größe und groß genug sein, um Nachrichten basierend auf der Eingangsrate der MQTT-Nachrichten zu halten.  
Anzeigename in der AWS IoT Konsole: **Maximale Anzahl von Metriken, die im Speicher aufbewahrt** werden sollen  
Erforderlich: `true`  
Typ: `string`  
Gültiges Muster: `^[0-9]+$`

`AuthSecretArn`  <a name="service-now-AuthSecretArn"></a>
Das AWS Secrets Manager darin enthaltene Geheimnis speichert den ServiceNow Benutzernamen und das Passwort. Dies muss ein Texttyp Secret sein. Das Secret muss "Benutzer-" und "Passwort-"Schlüssel mit entsprechenden Werten enthalten.  
Anzeigename in der AWS IoT Konsole: **ARN of Auth Secret**  
Erforderlich: `true`  
Typ: `string`  
Gültiges Muster: `arn:aws:secretsmanager:[a-z0-9\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\]+/)*[a-zA-Z0-9/_+=,.@\-]+-[a-zA-Z0-9]+`

`AuthSecretArn-ResourceId`  <a name="service-now-AuthSecretArn-ResourceId"></a>
Die geheime Ressource in der Gruppe, die auf das Secrets Manager Manager-Geheimnis für die ServiceNow Anmeldeinformationen verweist.  
Anzeigename in der AWS IoT Konsole: **Auth-Token-Ressource**  
Erforderlich: `true`  
Typ: `string`  
Gültiges Muster: `.+`

------

### Beispiel für Connector erstellen (AWS CLI)
<a name="servicenow-connector-create"></a>

Der folgende CLI-Befehl erstellt eine `ConnectorDefinition` mit einer ersten Version, die den ServiceNow MetricBase Integrationsconnector enthält.

```
aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{
    "Connectors": [
        {
            "Id": "MyServiceNowMetricBaseIntegrationConnector",
            "ConnectorArn": "arn:aws:greengrass:{{region}}::/connectors/ServiceNowMetricBaseIntegration/versions/4",
            "Parameters": {
                "PublishInterval" : "10",
                "PublishBatchSize" : "50",
                "InstanceName" : "myinstance",
                "DefaultTableName" : "u_greengrass_app",
                "MaxMetricsToRetain" : "20000",
                "AuthSecretArn" : "arn:aws:secretsmanager:{{region}}:{{account-id}}:secret:greengrass-{{secret-hash}}",
                "AuthSecretArn-ResourceId" : "MySecretResource", 
                "IsolationMode" : "GreengrassContainer"
            }
        }
    ]
}'
```

**Anmerkung**  
Die Lambda-Funktion in diesem Konnektor hat einen [langlebigen Lebenszyklus](lambda-functions.md#lambda-lifecycle).

**In der AWS IoT Greengrass Konsole können Sie über die Connectors-Seite der Gruppe einen Connector hinzufügen.** Weitere Informationen finden Sie unter [Erste Schritte mit Greengrass-Konnektoren (Konsole)](connectors-console.md).

## Eingabedaten
<a name="servicenow-connector-data-input"></a>

Dieser Connector akzeptiert Zeitreihenmetriken zu einem MQTT-Thema und veröffentlicht die Metriken unter. ServiceNow Eingabenachrichten müssen im JSON-Format sein.

<a name="topic-filter"></a>**Themenfilter im Abonnement**  
`servicenow/metricbase/metric`

**Nachrichten-Eigenschaften**    
`request`  
Informationen über die Tabelle, den Datensatz und die Metrik. Diese Anforderung repräsentiert das Objekt `seriesRef` in einer Zeitreihen-POST-Anforderung. Weitere Informationen finden Sie unter [ Clotho Zeitreihen-API - POST](https://docs.servicenow.com/bundle/london-application-development/page/integrate/inbound-rest/concept/Clotho-Time-Series-API.html#clotho-POST-put).  
  
Erforderlich: `true`  
Typ: `object` der die folgenden Eigenschaften beinhaltet:    
`subject`  
Die `sys_id` des spezifischen Datensatzes in der Tabelle.  
Erforderlich: `true`  
Typ: `string`  
`metric_name`  
Der Metrik-Feldname.  
Erforderlich: `true`  
Typ: `string`  
`table`  
Der Name der Tabelle, in der der Datensatz gespeichert werden soll. Geben Sie diesen Wert an, um den Parameter `DefaultTableName` zu überschreiben.  
Erforderlich: `false`  
Typ: `string`  
`value`  
Der Wert des einzelnen Datenpunktes.  
Erforderlich: `true`  
Typ: `float`  
`timestamp`  
Der Zeitstempel des einzelnen Datenpunktes. Der Standardwert ist die aktuelle Zeit.  
Erforderlich: `false`  
Typ: `string`

**Beispieleingabe**  

```
{
    "request": {
        "subject":"ef43c6d40a0a0b5700c77f9bf387afe3",
        "metric_name":"u_count",
        "table": "u_greengrass_app"
        "value": 1.0,
        "timestamp": "2018-10-14T10:30:00"
    }
}
```

## Ausgabedaten
<a name="servicenow-connector-data-output"></a>

Dieser Connector veröffentlicht Statusinformationen als Ausgabedaten im MQTT-Thema.

<a name="topic-filter"></a>**Themenfilter im Abonnement**  
`servicenow/metricbase/metric/status`

**Beispielausgabe: Erfolg**  

```
{
    "response": {
        "metric_name": "Errors",
        "table_name": "GliderProd",
        "processed_on": "2018-10-14T10:35:00",
        "response_id": "khjKSkj132qwr23fcba",
        "status": "success",
        "values": [
            {
                "timestamp": "2016-10-14T10:30:00",
                "value": 1.0
            },
            {
                "timestamp": "2016-10-14T10:31:00",
                "value": 1.1
            }
        ]
    }
}
```

**Beispielausgabe: Fehler**  

```
{
    "response": {
        "error": "InvalidInputException",
        "error_message": "metric value is invalid",
        "status": "fail"
    }
}
```
Wenn der Connector einen Fehler erkennt, der wiederholt werden kann (z. B. Verbindungsfehler), versucht er die Veröffentlichung im nächsten Batch erneut.

## Beispiel für die Verwendung
<a name="servicenow-connector-usage"></a>

<a name="connectors-setup-intro"></a>Verwenden Sie die folgenden allgemeinen Schritte, um eine Python-3.7-Lambda-Beispielfunktion einzurichten, mit der Sie den Konnektor ausprobieren können.

**Anmerkung**  <a name="connectors-setup-get-started-topics"></a>
Wenn Sie andere Python-Laufzeiten verwenden, können Sie einen Symlink von Python3.x zu Python 3.7 erstellen.
In den Themen [Beginnen Sie mit Konnektoren (Konsole)](connectors-console.md) und [Erste Schritte mit Konnektoren (CLI)](connectors-cli.md) wird ausführlich beschrieben, wie Sie einen Beispielkonnektor für Twilio-Benachrichtigungen konfigurieren und bereitstellen.

1. Stellen Sie sicher, dass Sie die [Anforderungen](#servicenow-connector-req) für den Konnektor erfüllen.

1. <a name="connectors-setup-function"></a>Erstellen und veröffentlichen Sie eine Lambda-Funktion, die Eingabedaten an den Connector sendet.

   Speichern Sie den [Beispielcode](#servicenow-connector-usage-example) als PY-Datei. <a name="connectors-setup-function-sdk"></a>Laden Sie das [AWS IoT Greengrass Core SDK für Python](lambda-functions.md#lambda-sdks-core) herunter und entpacken Sie es. Erstellen Sie dann ein ZIP-Paket, das die PY-Datei und den Ordner `greengrasssdk` auf Stammebene enthält. Dieses Zip-Paket ist das Bereitstellungspaket, in das Sie AWS Lambda hochladen.

   <a name="connectors-setup-function-publish"></a>Nachdem Sie die Lambda-Funktion Python 3.7 erstellt haben, veröffentlichen Sie eine Funktionsversion und erstellen Sie einen Alias.

1. Konfigurieren Sie Ihre Greengrass-Gruppe.

   1. <a name="connectors-setup-gg-function"></a>Fügen Sie die Lambda-Funktion mit ihrem Alias hinzu (empfohlen). Konfigurieren Sie den Lambda-Lebenszyklus als langlebig (oder `"Pinned": true` in der CLI).

   1. <a name="connectors-setup-secret-resource"></a>Fügen Sie die erforderliche geheime Ressource hinzu und gewähren Sie der Lambda-Funktion Lesezugriff.

   1. Fügen Sie den Konnektor hinzu und konfigurieren Sie seine [Parameter](#servicenow-connector-param).

   1. Fügen Sie Abonnements hinzu, die es dem Konnektor ermöglichen, [Eingabedaten](#servicenow-connector-data-input) zu empfangen und [Ausgabedaten](#servicenow-connector-data-output) zu unterstützten Themenfiltern zu senden.
      + <a name="connectors-setup-subscription-input-data"></a>Legen Sie die Lambda-Funktion als Quelle und den Konnektor als Ziel fest und verwenden Sie einen unterstützten Eingabethemenfilter.
      + <a name="connectors-setup-subscription-output-data"></a>Legen Sie den Konnektor als Quelle und AWS IoT Core als Ziel fest und verwenden Sie einen unterstützten Ausgabethemenfilter. Sie verwenden dieses Abonnement, um Statusmeldungen in der AWS IoT Konsole anzuzeigen.

1. <a name="connectors-setup-deploy-group"></a>Stellen Sie die Gruppe bereit.

1. <a name="connectors-setup-test-sub"></a>Abonnieren Sie in der AWS IoT Konsole auf der **Testseite** das Thema Ausgabedaten, um Statusmeldungen vom Connector anzuzeigen. Die Lambda-Beispielfunktion ist langlebig und beginnt unmittelbar nach der Bereitstellung der Gruppe mit dem Senden von Nachrichten.

   Wenn Sie mit dem Testen fertig sind, können Sie den Lambda-Lebenszyklus auf On-Demand (oder `"Pinned": false` in der CLI) setzen und die Gruppe bereitstellen. Dadurch wird verhindert, dass die Funktion Nachrichten sendet.

### Beispiel
<a name="servicenow-connector-usage-example"></a>

Die folgende Lambda-Beispielfunktion sendet eine Eingabenachricht an den Konnektor.

```
import greengrasssdk
import json

iot_client = greengrasssdk.client('iot-data')
SEND_TOPIC = 'servicenow/metricbase/metric'

def create_request_with_all_fields():
    return {
        "request": {
             "subject": '2efdf6badbd523803acfae441b961961',
             "metric_name": 'u_count',
             "value": 1234,
             "timestamp": '2018-10-20T20:22:20',
             "table": 'u_greengrass_metricbase_test'
        }
    }

def publish_basic_message():
    messageToPublish = create_request_with_all_fields()
    print("Message To Publish: ", messageToPublish)
    iot_client.publish(topic=SEND_TOPIC,
        payload=json.dumps(messageToPublish))

publish_basic_message()

def lambda_handler(event, context):
    return
```

## Lizenzen
<a name="servicenow-connector-license"></a>

Der ServiceNow MetricBase Integrationskonnektor umfasst den folgenden Drittanbieter software/licensing:
+ [pysnow](https://github.com/rbw/pysnow)/MIT

Dieser Connector ist im Rahmen der [Greengrass Core Software-Lizenzvereinbarung](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf) veröffentlicht.

## Änderungsprotokoll
<a name="servicenow-connector-changelog"></a>

In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen des Connectors beschrieben.


| Version | Änderungen | 
| --- | --- | 
| 4 | <a name="isolation-mode-changelog"></a>Der Parameter `IsolationMode` wurde hinzugefügt, um den Containerisierungsmodus für den Konnektor zu konfigurieren. | 
| 3 | <a name="upgrade-runtime-py3.7"></a>Die Lambda-Laufzeit wurde auf Python 3.7 aktualisiert, was die Laufzeitanforderungen ändert. | 
| 2 | Beheben, um übermäßige Protokollierung zu reduzieren. | 
| 1 | Erstversion. | 

<a name="one-conn-version"></a>Eine Greengrass-Gruppe kann jeweils nur eine Version des Connectors enthalten. Weitere Informationen zum Aktualisieren einer Konnektorversion finden Sie unter [Aktualisieren von Konnektorversionen](connectors.md#upgrade-connector-versions).

## Weitere Informationen finden Sie auch unter
<a name="servicenow-connector-see-also"></a>
+ [Integrieren von Services und Protokollen mit Greengrass-Konnektoren](connectors.md)
+ [Erste Schritte mit Greengrass-Konnektoren (Konsole)](connectors-console.md)
+ [Erste Schritte mit Greengrass-Konnektoren (CLI)](connectors-cli.md)