Configurare i contenitori docker di Analisi del testoConfigure Text Analytics docker containers

Analisi del testo fornisce a ogni contenitore un framework di configurazione comune che consente di configurare e gestire con facilità le impostazioni di archiviazione, registrazione, telemetria e sicurezza dei contenitori.Text Analytics provides each container with a common configuration framework, so that you can easily configure and manage storage, logging and telemetry, and security settings for your containers. Sono disponibili anche alcuni comandi di esecuzione Docker di esempio .Several example docker run commands are also available.

Impostazioni di configurazioneConfiguration settings

Le impostazioni di configurazione del contenitore sono le seguenti:The container has the following configuration settings:

NecessarioRequired ImpostazioneSetting ScopoPurpose
Yes ApiKeyApiKey Tiene traccia delle informazioni di fatturazione.Tracks billing information.
NoNo ApplicationInsightsApplicationInsights Consente di aggiungere al contenitore il supporto per i dati di telemetria di Azure Application Insights.Enables adding Azure Application Insights telemetry support to your container.
Yes FatturazioneBilling Specifica l'URI dell'endpoint della risorsa del servizio in Azure.Specifies the endpoint URI of the service resource on Azure.
Yes EulaEula Indica che è stata accettata la licenza per il contenitore.Indicates that you've accepted the license for the container.
NoNo FluentdFluentd Scrive il log e, facoltativamente, i dati delle metriche in un server Fluentd.Writes log and, optionally, metric data to a Fluentd server.
NoNo Proxy HTTPHTTP Proxy Configura un proxy HTTP per le richieste in uscita.Configures an HTTP proxy for making outbound requests.
NoNo LoggingLogging Fornisce il supporto di registrazione ASP.NET Core per il contenitore.Provides ASP.NET Core logging support for your container.
NoNo MountsMounts Legge e scrive i dati dal computer host al contenitore e dal contenitore al computer host.Reads and writes data from the host computer to the container and from the container back to the host computer.

Importante

Le ApiKey Billing Impostazioni, e Eula vengono usate insieme ed è necessario fornire valori validi per tutti e tre gli elementi; in caso contrario, il contenitore non verrà avviato.The ApiKey, Billing, and Eula settings are used together, and you must provide valid values for all three of them; otherwise your container won't start. Per altre informazioni sull'uso di queste impostazioni di configurazione per creare un'istanza di un contenitore, vedere Billing (Fatturazione).For more information about using these configuration settings to instantiate a container, see Billing.

Impostazione di configurazione ApiKeyApiKey configuration setting

L'impostazione ApiKey specifica la chiave di risorsa di Azure utilizzata per tenere traccia delle informazioni di fatturazione per il contenitore.The ApiKey setting specifies the Azure resource key used to track billing information for the container. È necessario specificare un valore per ApiKey e il valore deve essere una chiave di configurazione valida per la risorsa Analisi del testo specificata per l'impostazione di configurazione Billing.You must specify a value for the ApiKey and the value must be a valid key for the Text Analytics resource specified for the Billing configuration setting.

Questa impostazione è disponibile nelle posizioni seguenti:This setting can be found in the following place:

  • Portale di Azure: analisi del testo gestione delle risorse, in chiaviAzure portal: Text Analytics resource management, under Keys

Impostazione ApplicationInsightsApplicationInsights setting

L'impostazione ApplicationInsights consente di aggiungere al contenitore il supporto per i dati di telemetria di Azure Application Insights.The ApplicationInsights setting allows you to add Azure Application Insights telemetry support to your container. Application Insights offre funzionalità di monitoraggio avanzate del contenitore.Application Insights provides in-depth monitoring of your container. È possibile monitorare con facilità la disponibilità, le prestazioni e l'utilizzo del contenitore.You can easily monitor your container for availability, performance, and usage. È anche possibile identificare e diagnosticare rapidamente gli errori nel contenitore.You can also quickly identify and diagnose errors in your container.

La tabella seguente illustra le impostazioni di configurazione supportate nella sezione ApplicationInsights.The following table describes the configuration settings supported under the ApplicationInsights section.

NecessarioRequired NomeName Tipo di datiData type DescrizioneDescription
NoNo InstrumentationKey stringString Chiave di strumentazione dell'istanza di Application Insights a cui vengono inviati i dati di telemetria per il contenitore.The instrumentation key of the Application Insights instance to which telemetry data for the container is sent. Per altre informazioni, vedere Application Insights per ASP.NET Core.For more information, see Application Insights for ASP.NET Core.

Esempio:Example:
InstrumentationKey=123456789

Impostazione di configurazione BillingBilling configuration setting

L'impostazione Billing specifica l'URI dell'endpoint della risorsa di Analisi del testo in Azure usata per controllare le informazioni di fatturazione per il contenitore.The Billing setting specifies the endpoint URI of the Text Analytics resource on Azure used to meter billing information for the container. È necessario specificare un valore per questa impostazione di configurazione e il valore deve essere un URI di endpoint valido per una risorsa _ analisi del testo in Azure.You must specify a value for this configuration setting, and the value must be a valid endpoint URI for a _ Text Analytics resource on Azure. Il contenitore segnala l'utilizzo ogni 10-15 minuti.The container reports usage about every 10 to 15 minutes.

Questa impostazione è disponibile nelle posizioni seguenti:This setting can be found in the following place:

  • Portale di Azure: Panoramica analisi del testo , con etichetta EndpointAzure portal: Text Analytics Overview, labeled Endpoint
NecessarioRequired NomeName Tipo di datiData type DescrizioneDescription
Yes Billing stringString URI dell'endpoint di fatturazione.Billing endpoint URI. Per ulteriori informazioni su come ottenere l'URI di fatturazione, vedere raccolta dei parametri obbligatori.For more information on obtaining the billing URI, see gathering required parameters. Per altre informazioni e per un elenco completo degli endpoint a livello di area, vedere Nomi di sottodomini personalizzati per Servizi cognitivi.For more information and a complete list of regional endpoints, see Custom subdomain names for Cognitive Services.

Impostazione EulaEula setting

L'impostazione Eula indica che è stata accettata la licenza per il contenitore.The Eula setting indicates that you've accepted the license for the container. È necessario specificare un valore per questa impostazione di configurazione e tale valore deve essere impostato su accept.You must specify a value for this configuration setting, and the value must be set to accept.

NecessarioRequired NomeName Tipo di datiData type DescrizioneDescription
Yes Eula stringString Accettazione della licenzaLicense acceptance

Esempio:Example:
Eula=accept

I contenitori di Servizi cognitivi sono concessi in licenza in base al contratto che disciplina l'uso di Azure.Cognitive Services containers are licensed under your agreement governing your use of Azure. Se non si dispone di un contratto esistente che disciplina l'uso di Azure, l'utente accetta che il contratto che disciplina l'uso di Azure sia il contratto di sottoscrizione Microsoft Online, che include le condizioni per i servizi online.If you do not have an existing agreement governing your use of Azure, you agree that your agreement governing use of Azure is the Microsoft Online Subscription Agreement, which incorporates the Online Services Terms. Per le anteprime si accettano inoltre le Condizioni Supplementari per l'Utilizzo delle Anteprime di Microsoft Azure.For previews, you also agree to the Supplemental Terms of Use for Microsoft Azure Previews. Con l'uso del contenitore si acconsente a rispettare tali condizioni.By using the container you agree to these terms.

Impostazioni FluentdFluentd settings

Fluentd è un agente di raccolta dati open source per la registrazione unificata.Fluentd is an open-source data collector for unified logging. Le impostazioni Fluentd gestiscono la connessione del contenitore a un server Fluentd.The Fluentd settings manage the container's connection to a Fluentd server. Il contenitore include un provider di registrazione di Fluentd che consente al contenitore di scrivere log e, facoltativamente, dati delle metriche in un server di Fluentd.The container includes a Fluentd logging provider, which allows your container to write logs and, optionally, metric data to a Fluentd server.

La tabella seguente illustra le impostazioni di configurazione supportate nella sezione Fluentd.The following table describes the configuration settings supported under the Fluentd section.

NomeName Tipo di datiData type DescrizioneDescription
Host stringString Indirizzo IP o nome host DNS del server Fluentd.The IP address or DNS host name of the Fluentd server.
Port IntegerInteger Porta del server Fluentd.The port of the Fluentd server.
Il valore predefinito è 24224.The default value is 24224.
HeartbeatMs IntegerInteger Intervallo di heartbeat, espresso in millisecondi.The heartbeat interval, in milliseconds. Se prima della scadenza di questo intervallo è non stato inviato alcun traffico dell'evento, viene inviato un heartbeat al server Fluentd.If no event traffic has been sent before this interval expires, a heartbeat is sent to the Fluentd server. Il valore predefinito è 60000 millisecondi (1 minuto).The default value is 60000 milliseconds (1 minute).
SendBufferSize IntegerInteger Spazio di buffer di rete, espresso in byte, allocato per le operazioni di invio.The network buffer space, in bytes, allocated for send operations. Il valore predefinito è 32768 byte (32 kilobyte).The default value is 32768 bytes (32 kilobytes).
TlsConnectionEstablishmentTimeoutMs IntegerInteger Timeout, espresso in millisecondi, per stabilire una connessione SSL/TLS con il server Fluentd.The timeout, in milliseconds, to establish a SSL/TLS connection with the Fluentd server. Il valore predefinito è 10000 millisecondi (10 secondi).The default value is 10000 milliseconds (10 seconds).
Se UseTLS è impostato su false, questo valore viene ignorato.If UseTLS is set to false, this value is ignored.
UseTLS BooleanBoolean Indica se il contenitore deve usare SSL/TLS per comunicare con il server Fluentd.Indicates whether the container should use SSL/TLS for communicating with the Fluentd server. Il valore predefinito è false.The default value is false.

Impostazioni delle credenziali del proxy HTTPHttp proxy credentials settings

Se è necessario configurare un proxy HTTP per eseguire le richieste in uscita, usare questi due argomenti:If you need to configure an HTTP proxy for making outbound requests, use these two arguments:

NomeName Tipo di datiData type DescrizioneDescription
HTTP_PROXYHTTP_PROXY stringstring Il proxy da usare, ad esempio, http://proxy:8888The proxy to use, for example, http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDSHTTP_PROXY_CREDS stringstring Tutte le credenziali necessarie per l'autenticazione nel proxy, ad esempio username:password .Any credentials needed to authenticate against the proxy, for example, username:password. Questo valore deve essere in lettere minuscole.This value must be in lower-case.
<proxy-user> stringstring L'utente per il proxy.The user for the proxy.
<proxy-password> stringstring La password associata a <proxy-user> per il proxy.The password associated with <proxy-user> for the proxy.
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> \
HTTP_PROXY=<proxy-url> \
HTTP_PROXY_CREDS=<proxy-user>:<proxy-password> \

Impostazioni di registrazioneLogging settings

Le impostazioni Logging gestiscono il supporto di registrazione di ASP.NET Core per il contenitore.The Logging settings manage ASP.NET Core logging support for your container. È possibile usare le stesse impostazioni di configurazione e gli stessi valori per il contenitore che si usano per un'applicazione ASP.NET Core.You can use the same configuration settings and values for your container that you use for an ASP.NET Core application.

I provider di registrazione seguenti sono supportati dal contenitore:The following logging providers are supported by the container:

ProviderProvider ScopoPurpose
ConsoleConsole Provider di registrazione Console di ASP.NET Core.The ASP.NET Core Console logging provider. Tutti i valori predefiniti e le impostazioni di configurazione di ASP.NET Core per questo provider di registrazione sono supportati.All of the ASP.NET Core configuration settings and default values for this logging provider are supported.
Eseguire il debugDebug Provider di registrazione Debug di ASP.NET Core.The ASP.NET Core Debug logging provider. Tutti i valori predefiniti e le impostazioni di configurazione di ASP.NET Core per questo provider di registrazione sono supportati.All of the ASP.NET Core configuration settings and default values for this logging provider are supported.
DiscoDisk Provider di registrazione JSON.The JSON logging provider. Questo provider di registrazione scrive i dati di log nel montaggio di output.This logging provider writes log data to the output mount.

Questo comando del contenitore archivia informazioni di registrazione nel formato JSON al montaggio di output:This container command stores logging information in the JSON format to the output mount:

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

Questo comando del contenitore visualizza informazioni di debug, con il prefisso dbug, durante l'esecuzione del contenitore:This container command shows debugging information, prefixed with dbug, while the container is running:

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 discoDisk logging

Il provider di registrazione Disk supporta le impostazioni di configurazione seguenti:The Disk logging provider supports the following configuration settings:

NomeName Tipo di datiData type DescrizioneDescription
Format stringString Formato di output dei file di log.The output format for log files.
Nota: per abilitare il provider di registrazione, questo valore deve essere impostato su json.Note: This value must be set to json to enable the logging provider. 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.If this value is specified without also specifying an output mount while instantiating a container, an error occurs.
MaxFileSize IntegerInteger Dimensione massima, espressa in megabyte (MB), di un file di log.The maximum size, in megabytes (MB), of a log file. 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.When the size of the current log file meets or exceeds this value, a new log file is started by the logging provider. Se viene specificato -1, la dimensione del file di log è limitata solo dalla dimensione massima del file del montaggio di output eventualmente presente.If -1 is specified, the size of the log file is limited only by the maximum file size, if any, for the output mount. Il valore predefinito è 1.The default value is 1.

Per altre informazioni sulla configurazione del supporto di registrazione di ASP.NET Core, vedere Registrazione in ASP.NET Core.For more information about configuring ASP.NET Core logging support, see Settings file configuration.

Impostazioni di montaggioMount settings

Usare montaggi di associazione per leggere e scrivere dati da e verso il contenitore.Use bind mounts to read and write data to and from the container. È possibile specificare un montaggio di input o di output specificando l'opzione --mount nel comando docker run.You can specify an input mount or output mount by specifying the --mount option in the docker run command.

Il contenitore Analisi del testo non usa montaggi di input o output per archiviare i dati di training o di servizio.The Text Analytics containers don't use input or output mounts to store training or service data.

La sintassi esatta della posizione di montaggio host varia a seconda del sistema operativo host.The exact syntax of the host mount location varies depending on the host operating system. Inoltre, il percorso di montaggio del computer hostpotrebbe non essere accessibile a causa di un conflitto tra le autorizzazioni utilizzate dall'account del servizio Docker e le autorizzazioni del percorso di montaggio dell'host.Additionally, the host computer's mount location may not be accessible due to a conflict between permissions used by the docker service account and the host mount location permissions.

FacoltativoOptional NomeName Tipo di datiData type DescrizioneDescription
Non consentitoNot allowed Input stringString I contenitori di Analisi del testo non la usano.Text Analytics containers do not use this.
FacoltativoOptional Output StringString Destinazione del montaggio di output.The target of the output mount. Il valore predefinito è /output.The default value is /output. Questo è il percorso dei log.This is the location of the logs. Include i log dei contenitori.This includes container logs.

Esempio:Example:
--mount type=bind,src=c:\output,target=/output

Passaggi successiviNext steps