Konfigurieren von Docker-Containern für Azure AI Health Insights

Der Azure AI Health Insights-Dienst bietet jedem Container ein gemeinsames Konfigurationsframework, sodass Sie Speicher, Protokollierung und Telemetrie sowie Sicherheitseinstellungen für Ihre Container problemlos 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.
Nein	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 verantwortlicher KI-Bedingungen 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 den ApiKey angeben, und der Wert muss ein gültiger Schlüssel für die Health Insights-Ressource sein, die für die Billing Konfigurationseinstellung angegeben ist.

Diese Einstellung finden Sie hier:

• Azure-Portal: Health Insights-Ressourcenverwaltung 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 bietet eine eingehende Überwachung Ihres Containers. 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 Billing Einstellung gibt den Endpunkt-URI der Ressource in Azure an, die verwendet wird, um Abrechnungsinformationen für den Container zu ermitteln. Sie müssen einen Wert für diese Konfigurationseinstellung angeben, und der Wert muss ein gültiger Endpunkt-URI für eine Ressource in Azure sein. Der Container meldet die Nutzung etwa alle 10 bis 15 Minuten.

Diese Einstellung finden Sie hier:

• Azure-Portal: Health Insights Overview, labeledEndpoint

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	Beispiel für die Lizenzakzeptanz :Eula=accept

Azure AI Health Insights-Container werden gemäß Ihrer Vereinbarung für Ihre Nutzung von Azure lizenziert. Wenn Sie nicht über eine Vereinbarung für Ihre Nutzung von Azure verfügen, stimmen Sie zu, dass Ihre Vertragsnutzung von Azure der Microsoft Online-Abonnementvertrag ist, der die Onlinedienstebedingungen enthält. Für Vorschauversionen stimmen Sie auch den ergänzenden Nutzungsbedingungen für Microsoft Azure-Vorschauversionen zu. Durch die Nutzung des Containers stimmen Sie diesen Bedingungen zu.

EINSTELLUNG FÜR RAI-Bedingungen

Die RAI_Terms Einstellung gibt an, dass verantwortungsvolle KI-Begriffe akzeptiert werden. Sie müssen einen Wert für diese Konfigurationseinstellung angeben, und dieser Wert muss auf "accept" festgelegt werden.

Erforderlich	Name	Datentyp	Beschreibung
Ja	RAI_Terms	String	Verantwortungsvolle KI-Begriffe Akzeptieren Beispiel:RAI_Terms=accept

Logging-Einstellungen

Die Logging Einstellungen verwalten die Protokollierungsunterstützung für Ihren Container. Sie können dieselben Konfigurationseinstellungen und Werte für Ihren Container verwenden, den Sie für eine ASP.NET Core-Anwendungen verwenden.

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 so festgelegt werden, dass json der Protokollierungsanbieter aktiviert wird. 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.