Konfigurieren von Azure KI Health Insights-Docker-Containern

Der Azure KI Health Insights-Dienst stellt für jeden Container ein allgemeines Konfigurationsframework bereit, sodass Sie ganz einfach Aspekte wie Speicher, Protokollierung und Telemetrie sowie Sicherheitseinstellungen für Ihre Container konfigurieren und verwalten können. Mehrere Beispiele für docker run-Befehle sind ebenfalls verfügbar.

Konfigurationseinstellungen

Der Container hat die folgenden Konfigurationseinstellungen:

Erforderlich	Einstellung	Zweck
Ja	ApiKey	Nachverfolgen von Abrechnungsinformationen
Ja	Abrechnung	Gibt den Endpunkt-URI der Dienstressource in Azure an.
Ja	Eula	Gibt an, dass Sie die Lizenz für den Container akzeptiert haben.
No	ApplicationInsights__InstrumentationKey	Ermöglicht das Hinzufügen von Unterstützung für Azure Application Insights-Telemetriedaten in Ihrem Container.
Ja	RAI_Terms	Gibt die Annahme der Bestimmungen für verantwortungsvolle KI an.

Wichtig

Die Einstellungen ApiKey, Billing und Eula werden gemeinsam verwendet, und Sie müssen gültige Werte für alle drei angeben, da der Container andernfalls nicht startet. Weitere Informationen zum Instanziieren eines Containers mithilfe dieser Konfigurationseinstellungen finden Sie unter Abrechnung.

Konfigurationseinstellung „ApiKey“

Die ApiKey-Einstellung gibt den Schlüssel der Azure-Ressourcen an, mit dem die Abrechnungsinformationen für den Container verfolgt werden. Sie müssen einen Wert für „ApiKey“ angeben. Bei diesem Wert muss es sich um einen gültigen Schlüssel für die Ressource vom Typ Health Insights handeln, die für die Konfigurationseinstellung Billing angegeben wurde.

Diese Einstellung finden Sie hier:

• Azure-Portal: Ressourcenverwaltung für Health Insights unter Schlüssel und Endpunkt

ApplicationInsights-Einstellung

Die ApplicationInsights-Einstellung ermöglicht das Hinzufügen von Unterstützung für Azure Application Insights-Telemetriedaten in Ihrem Container. Der Application Insights-Dienst ermöglicht eine tief greifende Überwachung Ihrer Container. Sie können ganz einfach die Verfügbarkeit, Leistung und Nutzung Ihrer Container überwachen. Außerdem können Sie schnell Fehler in Ihrem Container erkennen und diagnostizieren.

In der folgenden Tabelle werden die Konfigurationseinstellungen beschrieben, die unter dem Abschnitt ApplicationInsights unterstützt werden.

Erforderlich	Name	Datentyp	BESCHREIBUNG
Nein	InstrumentationKey	String	Der Instrumentierungsschlüssel der Application Insights-Instanz, an die Telemetriedaten für den Container gesendet werden.

Konfigurationseinstellung „Billing“

Die Einstellung Billing gibt den Endpunkt-URI der Ressource in Azure an, der zum Messen der Abrechnungsinformationen für den Container verwendet wird. Sie müssen einen Wert für diese Konfigurationseinstellung angeben, und bei dem Wert muss es sich um einen gültigen URI-Endpunkt für eine Ressource in Azure handeln. Der Container meldet die Nutzung etwa alle 10 bis 15 Minuten.

Diese Einstellung finden Sie hier:

• Azure-Portal: Health Insights-Übersicht, Bezeichnung Endpoint

Erforderlich	Name	Datentyp	Beschreibung
Ja	Billing	String	URI des Abrechnungsendpunkts. Weitere Informationen zum Erhalt eines Abrechnungs-URI finden Sie unter Erfassen erforderlicher Parameter.

Eula-Einstellung

Die Eula-Einstellung gibt an, dass Sie die Lizenz für den Container akzeptiert haben. Sie müssen einen Wert für diese Konfigurationseinstellung angeben, und der Wert muss auf accept festgelegt werden.

Erforderlich	Name	Datentyp	Beschreibung
Ja	Eula	String	Zustimmung zur Lizenz Beispiel: Eula=accept

Azure KI Health Insights-Container werden im Rahmen Ihres Vertrags lizenziert, der Ihre Nutzung von Azure regelt. Wenn Sie über keine Vereinbarung zur Nutzung von Azure verfügen, bestätigen Sie, dass Ihre Vereinbarung zur Nutzung von Azure der Microsoft Online-Abonnementvertrag ist, der die Nutzungsbedingungen für Onlinedienste umfasst. Für Vorschauversionen stimmen Sie auch den ergänzenden Nutzungsbedingungen für Microsoft Azure-Vorschauversionen zu. Durch die Nutzung von Containern stimmen Sie diesen Bedingungen zu.

Einstellung der Bestimmungen für verantwortungsvolle KI

Die Einstellung RAI_Terms gibt die Annahme der Bedingungen für verantwortungsvolle KI an. Sie müssen einen Wert für diese Konfigurationseinstellung angeben, und der Wert muss auf „Annehmen” festgelegt werden.

Erforderlich	Name	Datentyp	Beschreibung
Ja	RAI_Terms	String	Akzeptieren der Bestimmungen für verantwortungsvolle KI Beispiel: RAI_Terms=accept

Logging-Einstellungen

Die Logging-Einstellungen dienen zur Verwaltung der Protokollierungsunterstützung für Ihren Container. Sie können für Ihren Container die gleichen Konfigurationseinstellungen und Werte verwenden wie für ASP.NET Core-Anwendungen.

Der Container unterstützt folgende Protokollanbieter:

Anbieter	Zweck
Konsole	Der ASP.NET Core-Protokollierungsanbieter Console. Alle ASP.NET Core-Konfigurationseinstellungen und Standardwerte für diesen Protokollanbieter werden unterstützt.
Debuggen	Der ASP.NET Core-Protokollierungsanbieter Debug. Alle ASP.NET Core-Konfigurationseinstellungen und Standardwerte für diesen Protokollanbieter werden unterstützt.
Datenträger	Der JSON-Protokollanbieter. Dieser Protokollanbieter schreibt Protokolldaten in die Ausgabeeinbindung.

Dieser Containerbefehl speichert Protokollierungsinformationen im JSON-Format für die Ausgabeeinbindung:

docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Disk:Format=json \
Mounts:Output=/output

Dieser Containerbefehl zeigt Debuginformationen an, denen debug vorangestellt ist, während der Container ausgeführt wird:

docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Console:LogLevel:Default=Debug

Datenträgerprotokollierung

Der Protokollanbieter Disk unterstützt folgende Konfigurationseinstellungen:

Name	Datentyp	Beschreibung
Format	String	Das Ausgabeformat für Protokolldateien. Hinweis: Dieser Wert muss auf json festgelegt werden, um den Protokollanbieter zu aktivieren. Wenn dieser Wert bei der Containerinstanziierung angegeben wird, ohne eine Ausgabeeinbindung anzugeben, tritt ein Fehler auf.
MaxFileSize	Integer	Die maximale Größe einer Protokolldatei (in MB). Wenn die Größe der aktuellen Protokolldatei diesen Wert erreicht oder übersteigt, wird vom Protokollanbieter eine neue Protokolldatei erstellt. Bei Angabe von „-1“ wird die Größe der Protokolldatei nur durch die maximal zulässige Dateigröße für die Ausgabeeinbindung begrenzt (sofern vorhanden). Der Standardwert ist 1.