Configurare i contenitori Docker di Azure AI Health Insights

Articolo
05/05/2024

Il servizio Azure AI Health Insights offre a ogni contenitore un framework di configurazione comune, in modo da poter configurare e gestire facilmente archiviazione, registrazione e telemetria e impostazioni di sicurezza per i contenitori. Sono disponibili anche diversi comandi docker run.

Impostazioni di configurazione

Le impostazioni di configurazione del contenitore sono le seguenti:

Richiesto	Impostazione	Scopo
Sì	ApiKey	Tiene traccia delle informazioni di fatturazione.
Sì	Fatturazione	Specifica l'URI dell'endpoint della risorsa del servizio in Azure.
Sì	Eula	Indica che è stata accettata la licenza per il contenitore.
No	ApplicationInsights__InstrumentationKey	Consente di aggiungere al contenitore il supporto per i dati di telemetria di Azure Application Insights.
Sì	RAI_Terms	Indica l'accettazione delle condizioni di IA responsabile.

Importante

Le impostazioni ApiKey, Billing e Eula vengono usate insieme ed è necessario fornire valori validi per tutte e tre, altrimenti il contenitore non verrà avviato. Per altre informazioni sull'uso di queste impostazioni di configurazione per creare un'istanza di un contenitore, vedere Billing (Fatturazione).

Impostazione di configurazione ApiKey

L'impostazione ApiKey specifica la chiave di risorsa di Azure utilizzata per tenere traccia delle informazioni di fatturazione per il contenitore. È necessario specificare un valore per ApiKey e il valore deve essere una chiave valida per la risorsa Di Health Insights specificata per l'impostazione Billing di configurazione.

Questa impostazione è disponibile nelle posizioni seguenti:

portale di Azure: Gestione delle risorse di Health Insights, in Chiavi ed endpoint

Impostazione ApplicationInsights

L'impostazione ApplicationInsights consente di aggiungere al contenitore il supporto per i dati di telemetria di Azure Application Insights. Il servizio Application Insights fornisce un monitoraggio approfondito del contenitore. È possibile monitorare con facilità la disponibilità, le prestazioni e l'utilizzo del contenitore. È anche possibile identificare e diagnosticare rapidamente gli errori nel contenitore.

La tabella seguente illustra le impostazioni di configurazione supportate nella sezione ApplicationInsights.

Obbligatorio	Name	Tipo di dati	Descrizione
No	`InstrumentationKey`	Stringa	Chiave di strumentazione dell'istanza di Application Insights a cui vengono inviati i dati di telemetria per il contenitore.

Impostazione di configurazione Billing

L'impostazione Billing specifica l'URI dell'endpoint della risorsa in Azure usato per misurare le informazioni di fatturazione per il contenitore. È necessario specificare un valore per questa impostazione di configurazione e il valore deve essere un URI dell'endpoint valido per una risorsa in Azure. Il contenitore segnala l'utilizzo ogni 10-15 minuti.

Questa impostazione è disponibile nelle posizioni seguenti:

portale di Azure: Panoramica di Health Insights, etichettataEndpoint

Obbligatorio	Name	Tipo di dati	Descrizione
Sì	`Billing`	Stringa	URI dell'endpoint di fatturazione. Per altre informazioni su come ottenere l'URI di fatturazione, vedere Raccogliere i parametri obbligatori.

Impostazione Eula

L'impostazione Eula indica che è stata accettata la licenza per il contenitore. È necessario specificare un valore per questa impostazione di configurazione e tale valore deve essere impostato su accept.

Obbligatorio	Name	Tipo di dati	Descrizione
Sì	`Eula`	Stringa	Esempio di accettazione della licenza:`Eula=accept`

I contenitori di Azure AI Health Insights sono concessi in licenza con il contratto che regola l'uso di Azure. Se non si dispone di un contratto esistente che regola l'uso di Azure, si accetta che l'uso del contratto di Azure sia il Contratto di sottoscrizione online Microsoft, che incorpora le Condizioni per i servizi online. Per le anteprime si accettano inoltre le Condizioni Supplementari per l'Utilizzo delle Anteprime di Microsoft Azure. Usando il contenitore, si accettano queste condizioni.

Impostazione di RAI-Terms

L'impostazione RAI_Terms indica l'accettazione delle condizioni di intelligenza artificiale responsabile. È necessario specificare un valore per questa impostazione di configurazione e questo valore deve essere impostato su 'accept'.

Obbligatorio	Name	Tipo di dati	Descrizione
Sì	`RAI_Terms`	Stringa	Esempio di accettazione delle condizioni di intelligenza artificiale responsabile:`RAI_Terms=accept`

Impostazioni di registrazione

Le Logging impostazioni gestiscono il supporto della registrazione per il contenitore. È possibile usare le stesse impostazioni di configurazione e gli stessi valori per il contenitore usato per le applicazioni ASP.NET Core.

I provider di registrazione seguenti sono supportati dal contenitore:

Provider	Scopo
Console	Provider di registrazione `Console` di ASP.NET Core. Tutti i valori predefiniti e le impostazioni di configurazione di ASP.NET Core per questo provider di registrazione sono supportati.
Debug	Provider di registrazione `Debug` di ASP.NET Core. Tutti i valori predefiniti e le impostazioni di configurazione di ASP.NET Core per questo provider di registrazione sono supportati.
Disco	Provider di registrazione JSON. Questo provider di registrazione scrive i dati di log nel montaggio di output.

Questo comando del contenitore archivia informazioni di registrazione nel formato JSON al montaggio di output:

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

Questo comando del contenitore visualizza informazioni di debug, con il prefisso debug, durante l'esecuzione del contenitore:

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

Registrazione su disco

Il provider di registrazione Disk supporta le impostazioni di configurazione seguenti:

Name	Tipo di dati	Descrizione
`Format`	Stringa	Formato di output dei file di log. Nota: questo valore deve essere impostato su `json` per abilitare il provider di registrazione. Se questo valore viene specificato senza specificare anche un montaggio di output durante la creazione di un'istanza di un contenitore, si verifica un errore.
`MaxFileSize`	Intero	Dimensione massima, espressa in megabyte (MB), di un file di log. Quando la dimensione del file di log corrente corrisponde a questo valore o lo supera, il provider di registrazione avvia un nuovo file di log. Se viene specificato -1, la dimensione del file di log è limitata solo dalla dimensione massima del file del montaggio di output eventualmente presente. Il valore predefinito è 1.

Condividi tramite