Text Analytics konfigurálása állapot docker-tárolókhoz
Text Analytics az állapot minden tárolóhoz egy közös konfigurációs keretrendszert biztosít, így egyszerűen konfigurálhatja és kezelheti a tárolók tárolási, naplózási és telemetriai beállításait, valamint biztonsági beállításait. Számos docker-futtatási parancs is elérhető.
Konfigurációs beállítások
A tároló a következő konfigurációs beállításokkal rendelkezik:
Kötelező | Beállítás | Rendeltetés |
---|---|---|
Igen | ApiKey | Nyomon követi a számlázási adatokat. |
Nem | ApplicationInsights | Lehetővé teszi Azure-alkalmazás Insights telemetriai támogatás hozzáadását a tárolóhoz. |
Igen | Számlázás | Megadja az Azure-beli szolgáltatáserőforrás végponti URI-ját. |
Igen | Eula | Azt jelzi, hogy elfogadta a tároló licencét. |
Nem | Fluentd | Naplót és opcionálisan metrikaadatokat ír egy Fluentd-kiszolgálóra. |
Nem | HTTP-proxy | HTTP-proxyt konfigurál a kimenő kérések végrehajtásához. |
Nem | Logging | ASP.NET Core naplózási támogatást biztosít a tárolóhoz. |
Nem | Tartók | Beolvassa és beírja az adatokat a gazdaszámítógépről a tárolóba, majd a tárolóból vissza a gazdaszámítógépre. |
Fontos
A ApiKey
, Billing
és Eula
a beállítások együtt használatosak, és mind a háromhoz érvényes értékeket kell megadnia; ellenkező esetben a tároló nem indul el. További információ arról, hogy a konfigurációs beállítások használatával példányosíthat egy tárolót, lásd: Számlázás.
ApiKey-konfigurációs beállítás
A ApiKey
beállítás megadja a tároló számlázási adatainak nyomon követéséhez használt Azure-erőforráskulcsot. Meg kell adnia egy értéket az ApiKey számára, és az értéknek érvényes kulcsnak kell lennie a konfigurációs beállításhoz megadott nyelvi erőforráshoz Billing
.
Ez a beállítás a következő helyen található:
- Azure Portal: Nyelvi erőforrás-kezelés a Kulcsok és végpont területen
ApplicationInsights-beállítás
Ezzel a ApplicationInsights
beállítással Azure-alkalmazás Insights-telemetria-támogatást adhat a tárolóhoz. Az Application Insights a tároló részletes monitorozását biztosítja. A tárolót egyszerűen monitorozhatja a rendelkezésre állás, a teljesítmény és a használat szempontjából. Emellett gyorsan azonosíthatja és diagnosztizálhatja a tároló hibáit.
Az alábbi táblázat a szakaszban támogatott ApplicationInsights
konfigurációs beállításokat ismerteti.
Kötelező | Name | Adattípus | Leírás |
---|---|---|---|
Nem | InstrumentationKey |
Sztring | Annak az Application Insights-példánynak a rendszerállapotkulcsa, amelyre a tároló telemetriai adatait elküldi a rendszer. További információ: Application Insights for ASP.NET Core. Példa: InstrumentationKey=123456789 |
Számlázási konfigurációs beállítás
A Billing
beállítás megadja a tároló számlázási adatainak mérésére használt Azure-beli nyelvi erőforrás végponti URI-ját. Meg kell adnia egy értéket ehhez a konfigurációs beállításhoz, és az értéknek érvényes végponti URI-nak kell lennie egy Azure-beli nyelvi erőforráshoz. A tároló körülbelül 10–15 percenként jelenti a használatot.
Ez a beállítás a következő helyen található:
- Azure Portal: Nyelvi áttekintés, címkével ellátva
Endpoint
Kötelező | Name | Adattípus | Leírás |
---|---|---|---|
Igen | Billing |
Sztring | Számlázási végpont URI-ja. A számlázási URI beszerzéséről további információt a szükséges paraméterek összegyűjtését ismertető cikkben talál. További információ és a regionális végpontok teljes listája: Egyéni altartománynevek az Azure AI-szolgáltatásokhoz. |
Eula-beállítás
A Eula
beállítás azt jelzi, hogy elfogadta a tároló licencét. Ehhez a konfigurációs beállításhoz meg kell adnia egy értéket, az értéket pedig értékre kell állítani.accept
Kötelező | Name | Adattípus | Leírás |
---|---|---|---|
Igen | Eula |
Sztring | Licenc elfogadása Példa: Eula=accept |
Az Azure AI-szolgáltatások tárolóinak licencelése az Ön szerződése alapján, az Azure használatára vonatkozik. Ha nem rendelkezik az Azure használatára vonatkozó meglévő szerződéssel, elfogadja, hogy az Azure használatára vonatkozó szerződése a Microsoft Online Előfizetési Szerződés, amely tartalmazza az online szolgáltatási feltételeket. Az előzetes verziók esetében ön elfogadja a Microsoft Azure előzetes verziójára vonatkozó kiegészítő használati feltételeket is. A tároló használatával elfogadja ezeket a feltételeket.
Fluentd-beállítások
A Fluentd egy nyílt forráskódú adatgyűjtő az egységes naplózáshoz. A Fluentd
beállítások kezelik a tároló Fluentd-kiszolgálóval való kapcsolatát. A tároló tartalmaz egy Fluentd naplózási szolgáltatót, amely lehetővé teszi, hogy a tároló naplókat és opcionálisan metrikaadatokat írjon egy Fluentd-kiszolgálóra.
Az alábbi táblázat a szakaszban támogatott Fluentd
konfigurációs beállításokat ismerteti.
Name | Adattípus | Leírás |
---|---|---|
Host |
Sztring | A Fluentd-kiszolgáló IP-címe vagy DNS-állomásneve. |
Port |
Egész szám | A Fluentd-kiszolgáló portja. Az alapértelmezett érték 24224. |
HeartbeatMs |
Egész szám | A szívverési időköz ezredmásodpercben. Ha az időköz lejárta előtt nem lett elküldve eseményforgalom, a rendszer szívverést küld a Fluentd-kiszolgálónak. Az alapértelmezett érték 60000 ezredmásodperc (1 perc). |
SendBufferSize |
Egész szám | A küldési műveletekhez lefoglalt hálózati pufferterület bájtban. Az alapértelmezett érték 32768 bájt (32 kilobájt). |
TlsConnectionEstablishmentTimeoutMs |
Egész szám | Az időtúllépés ezredmásodpercben, hogy SSL-/TLS-kapcsolatot létesítsen a Fluentd-kiszolgálóval. Az alapértelmezett érték 10000 ezredmásodperc (10 másodperc). Ha UseTLS false (hamis) értékre van állítva, a rendszer figyelmen kívül hagyja ezt az értéket. |
UseTLS |
Logikai | Azt jelzi, hogy a tárolónak SSL/TLS protokollt kell-e használnia a Fluentd-kiszolgálóval való kommunikációhoz. Az alapértelmezett érték a hamis. |
HTTP-proxy hitelesítő adatainak beállításai
Ha HTTP-proxyt kell konfigurálnia a kimenő kérések végrehajtásához, használja az alábbi két argumentumot:
Name | Adattípus | Leírás |
---|---|---|
HTTP_PROXY | sztring | A használni kívánt proxy, például: http://proxy:8888 <proxy-url> |
HTTP_PROXY_CREDS | sztring | A proxyn való hitelesítéshez szükséges hitelesítő adatok, például: username:password . Ennek az értéknek kisbetűsnek kell lennie. |
<proxy-user> |
sztring | A proxy felhasználója. |
<proxy-password> |
sztring | A proxyhoz társított <proxy-user> jelszó. |
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> \
Naplózási beállítások
A Logging
beállítások kezelik a tároló ASP.NET Core naplózási támogatását. Ugyanazokat a konfigurációs beállításokat és értékeket használhatja a tárolóhoz, amelyeket egy ASP.NET Core alkalmazáshoz használ.
A tároló a következő naplózási szolgáltatókat támogatja:
Szolgáltató | Cél |
---|---|
Console | A ASP.NET Core Console naplózási szolgáltató. A naplózási szolgáltató összes ASP.NET Core konfigurációs beállítása és alapértelmezett értéke támogatott. |
Hibakeresés | A ASP.NET Core Debug naplózási szolgáltató. A naplózási szolgáltató összes ASP.NET Core konfigurációs beállítása és alapértelmezett értéke támogatott. |
Lemez | A JSON-naplózási szolgáltató. Ez a naplózási szolgáltató naplóadatokat ír a kimeneti csatlakoztatáshoz. |
Ez a tárolóparancs JSON formátumban tárolja a naplózási adatokat a kimeneti csatlakoztatáshoz:
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
Ez a tárolóparancs a következő előtaggal dbug
ellátott hibakeresési információkat jeleníti meg, miközben a tároló fut:
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
Lemeznaplózás
A Disk
naplózási szolgáltató a következő konfigurációs beállításokat támogatja:
Name | Adattípus | Leírás |
---|---|---|
Format |
Sztring | A naplófájlok kimeneti formátuma. Megjegyzés: Ezt az értéket úgy kell beállítani, hogy json engedélyezze a naplózási szolgáltatót. Ha ez az érték anélkül van megadva, hogy kimeneti csatlakoztatást ad meg egy tároló példányosítása közben, hiba történik. |
MaxFileSize |
Egész szám | A naplófájlok maximális mérete megabájtban (MB). Ha az aktuális naplófájl mérete eléri vagy meghaladja ezt az értéket, a naplózási szolgáltató elindít egy új naplófájlt. Ha -1 van megadva, a naplófájl méretét csak a kimeneti csatlakoztatás maximális fájlmérete korlátozza( ha van ilyen). Az alapértelmezett érték az 1. |
További információ a ASP.NET Core naplózás támogatásának konfigurálásáról: Beállítások fájlkonfigurációja.
Csatlakoztatási beállítások
A bind-csatlakoztatásokkal adatokat olvashat és írhat a tárolóba és onnan. Bemeneti csatlakoztatást vagy kimeneti csatlakoztatást a docker-futtatási--mount
parancsban található beállítás megadásával adhat meg.
Text Analytics állapottárolók nem használnak bemeneti vagy kimeneti csatlakoztatásokat a betanítási vagy szolgáltatásadatok tárolására.
A gazdagép csatlakoztatási helyének pontos szintaxisa a gazdagép operációs rendszerétől függően változik. Emellett előfordulhat, hogy a gazdaszámítógép csatlakoztatási helye nem érhető el a Docker-szolgáltatásfiók által használt engedélyek és a gazdagép csatlakoztatási helyének engedélyei közötti ütközés miatt.
Választható | Name | Adattípus | Leírás |
---|---|---|---|
Nem engedélyezett | Input |
Sztring | Text Analytics állapottárolók nem használják ezt. |
Választható | Output |
Sztring | A kimeneti csatlakoztatás célja. Az alapértelmezett érték /output . Ez a naplók helye. Ide tartoznak a tárolónaplók is. Példa: --mount type=bind,src=c:\output,target=/output |
Következő lépések
- Tekintse át a tárolók telepítését és futtatását ismertető cikket
- További Azure AI-tárolók használata