Mengonfigurasi kontainer Detektor Anomali univariat

Lingkungan runtime kontainer Anomaly Detector dikonfigurasi menggunakan argumen perintah. Kontainer ini memiliki beberapa pengaturan yang diperlukan, beserta beberapa pengaturan opsional. Beberapa contoh perintah tersedia. Pengaturan khusus kontainer adalah pengaturan tagihan.

Pengaturan konfigurasi

Kontainer ini memiliki pengaturan konfigurasi berikut:

Diperlukan Pengaturan Tujuan
Ya ApiKey Digunakan untuk melacak informasi tagihan.
Tidak ApplicationInsights Memungkinkan Anda menambahkan dukungan telemetri Azure Application Insights ke kontainer Anda.
Ya Billing Menentukan URI titik akhir sumber daya layanan di Azure.
Ya Eula Menunjukkan bahwa Anda telah menerima lisensi untuk kontainer.
Tidak Fluentd Menulis log dan, secara opsional, data metrik ke server Fluentd.
Tidak Proksi Http Mengonfigurasi proksi HTTP untuk membuat permintaan keluar.
Tidak Pengelogan Memberikan dukungan pengelogan ASP.NET Core untuk kontainer Anda.
Tidak Pemasangan Membaca dan menulis data dari komputer host ke kontainer dan dari kontainer kembali ke komputer host.

Penting

Pengaturan ApiKey, Billing, dan Eula digunakan bersama-sama, dan Anda harus menyediakan nilai yang valid untuk ketiganya; jika tidak, kontainer Anda tidak akan dimulai. Untuk informasi selengkapnya tentang menggunakan pengaturan konfigurasi ini untuk membuat instans kontainer, lihat Tagihan.

Pengaturan konfigurasi ApiKey

Pengaturan ApiKey menentukan kunci sumber daya Azure yang digunakan untuk melacak informasi penagihan untuk kontainer. Anda harus menentukan nilai untuk ApiKey dan nilai harus menjadi kunci yang valid untuk sumber daya Detektor Anomali yang ditentukan untuk pengaturan konfigurasi.

Pengaturan ini dapat ditemukan di tempat berikut:

  • Portal Azure: Manajemen Sumber Daya Detektor Anomali, pada bagian Kunci

Pengaturan ApplicationInsights

Pengaturan ini ApplicationInsights memungkinkan Anda untuk menambahkan dukungan Insights telemetri Azure ApplicationInsights ke wadah Anda. Application Insights menyediakan pemantauan mendalam kontainer Anda. Anda dapat dengan mudah memantau kontainer untuk ketersediaan, performa, dan penggunaan. Anda juga dapat dengan cepat mengidentifikasi dan mendiagnosis kesalahan dalam kontainer.

Tabel berikut menjelaskan pengaturan konfigurasi yang didukung di bawah bagian ApplicationInsights.

Diperlukan Nama Jenis data Deskripsi
Tidak InstrumentationKey String Kunci instrumentasi instans Application Insights tempat data telemetri untuk kontainer dikirim. Untuk mengetahui informasi selengkapnya, lihat Application Insights untuk ASP.NET Core.

Contoh:
InstrumentationKey=123456789

Pengaturan konfigurasi tagihan

BillingPengaturan menentukan titik akhir URI dari sumber daya Billing pada Azure yang digunakan untuk mengukur informasi penagihan untuk kontainer. Anda harus menentukan nilai untuk pengaturan konfigurasi ini, dan nilainya harus berupa URI titik akhir yang valid untuk sumber daya Detektor Anomali di Azure.

Pengaturan ini dapat ditemukan di tempat berikut:

  • Azure portal: Anomaly Detector's Overview, diberi label
Diperlukan Nama Jenis data Deskripsi
Ya Billing String URI titik akhir tagihan. Untuk informasi selengkapnya tentang mendapatkan URI tagihan, lihat mengumpulkan parameter yang diperlukan. Untuk informasi selengkapnya dan daftar lengkap titik akhir wilayah, lihat Nama subdomain kustom untuk Cognitive Services.

Pengaturan Eula

Pengaturan Eula menunjukkan bahwa Anda telah menerima lisensi untuk kontainer. Anda harus menentukan nilai untuk pengaturan konfigurasi ini, dan nilainya harus diatur ke accept.

Diperlukan Nama Jenis data Deskripsi
Ya Eula String Penerimaan lisensi

Contoh:
Eula=accept

Kontainer Cognitive Services dilisensikan berdasarkan perjanjian Anda yang mengatur penggunaan Azure oleh Anda. Jika Anda tidak memiliki perjanjian yang sudah ada yang mengatur penggunaan Azure oleh Anda, Anda setuju bahwa perjanjian yang mengatur penggunaan Azure adalah Perjanjian Langganan Microsoft Online, yang menggabungkan Ketentuan Layanan Online. Untuk pratinjau, Anda juga menyetujui Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure. Dengan menggunakan kontainer, Anda menyetujui persyaratan ini.

Pengaturan Fluentd

Fluentd adalah kolektor data sumber terbuka untuk pengelogan terpadu. FluentdPengaturan mengelola koneksi kontainer ke server Fluentd Kontainer ini mencakup penyedia pembuatan log Fluentd, yang memungkinkan kontainer Anda menulis log dan, secara opsional, data metrik ke server Fluentd.

Tabel berikut menjelaskan pengaturan konfigurasi yang didukung di bawah bagian Fluentd.

Nama Jenis data Deskripsi
Host String Alamat IP atau nama host DNS server Fluentd.
Port Bilangan bulat Port server Fluentd.
Nilai defaultnya adalah 24224.
HeartbeatMs Bilangan bulat Interval heartbeat, dalam milidetik. Jika tidak ada lalu lintas peristiwa yang dikirim sebelum interval ini berakhir, heartbeat dikirim ke server Fluentd. Nilai defaultnya adalah 60000 milidetik (1 menit).
SendBufferSize Bilangan bulat Ruang buffer jaringan, dalam byte, dialokasikan untuk operasi pengiriman. Nilai default adalah 32768 byte (32 kilobyte).
TlsConnectionEstablishmentTimeoutMs Bilangan bulat Waktu habis, dalam milidetik, untuk membuat koneksi SSL/TLS dengan server Fluentd. Nilai defaultnya adalah 10000 milidetik (10 menit).
Jika UseTLS diatur ke false, nilai ini diabaikan.
UseTLS Boolean Menunjukkan apakah kontainer harus menggunakan SSL/TLS untuk berkomunikasi dengan server Fluentd. Nilai defaultnya adalah false.

Pengaturan info masuk proksi http

Jika Anda perlu mengonfigurasi proxy HTTP untuk membuat permintaan keluar, gunakan dua argumen berikut:

Nama Jenis data Deskripsi
HTTP_PROXY string Proksi yang akan digunakan, misalnya, http://proxy:8888
<proxy-url>
HTTP_PROXY_CREDS string Kredensial apa pun yang diperlukan untuk mengautentikasi terhadap proxy, misalnya, username:password. Nilai ini harus dalam huruf kecil.
<proxy-user> string Pengguna untuk proksi.
<proxy-password> string Kata sandi yang terkait dengan <proxy-user> untuk proksi.
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> \

Pengaturan pengelogan

Pengaturan Logging mengelola ASP.NET Core log support untuk kontainer Anda. Anda dapat menggunakan pengaturan konfigurasi dan nilai yang sama untuk kontainer yang Anda gunakan untuk ASP.NET Core.

Penyedia pembuatan log berikut didukung oleh kontainer:

Penyedia Tujuan
Konsol Penyedia log ASP.NET Console Core. Semua pengaturan konfigurasi ASP.NET dan nilai default untuk penyedia pembuatan log ini didukung.
Debug Penyedia log ASP.NET Debug Core. Semua pengaturan konfigurasi ASP.NET dan nilai default untuk penyedia pembuatan log ini didukung.
Disk Penyedia pencatatan log JSON. Penyedia pencatatan log ini menulis data log ke tempat output.

Perintah kontainer ini menyimpan informasi pencatatan dalam format JSON ke tempat 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

Perintah kontainer ini menunjukkan informasi debugging, dia awali dengan dbug, saat kontainer sedang berjalan:

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

Pencatatan log disk

Penyedia pencatatan log Disk mendukung setelan konfigurasi berikut ini:

Nama Jenis data Deskripsi
Format String Format output untuk file log.
Nota: Nilai ini harus diatur untuk mengaktifkan penyedia penebangan. Jika nilai ini ditentukan tanpa juga menentukan dudukan output saat instantiating kontainer, kesalahan terjadi.
MaxFileSize Bilangan bulat Ukuran maksimum, dalam megabyte (MB), dari file log. Ketika ukuran file log saat ini memenuhi atau melebihi nilai ini, file log baru dimulai oleh penyedia pembuatan log. Jika -1 dispesifikasikan, ukuran berkas log hanya dibatasi oleh ukuran berkas maksimum, jika ada, untuk keluaran mount. Nilai default adalah 1.

Untuk informasi selengkapnya tentang mengonfigurasi ASP.NET log Core, lihat Pengaturan konfigurasi file.

Pengaturan pasang

Gunakan pasang ikatan untuk membaca dan menulis data ke dan dari kontainer. Anda dapat menentukan mount input atau mount output dengan menentukan --mount opsi dalam perintah --mount

Kontainer Detektor Anomali tidak menggunakan pemasangan input atau output untuk menyimpan data pelatihan atau layanan.

Sintaks yang tepat untuk lokasi pemasangan host bervariasi tergantung sistem operasi host. Selain itu, lokasi pemasangan komputer host mungkin tidak dapat diakses karena konflik antara izin yang digunakan oleh akun layanan Docker dan izin lokasi pemasangan host.

Opsional Nama Jenis data Deskripsi
Tidak diizinkan Input String Kontainer Detektor Anomali tidak menggunakan ini.
Opsional Output String Target dari pemasangan output. Nilai defaultnya adalah /output. Ini adalah lokasi log. Ini termasuk log kontainer.

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

Contoh perintah eksekusi docker

Contoh berikut menggunakan pengaturan konfigurasi untuk mengilustrasikan cara menulis dan menggunakan perintah docker run. Setelah berjalan, kontainer terus berjalan sampai Anda menghentikannya.

  • Karakter line-continuation:Perintah Docker di bagian berikut menggunakan garis miring belakang, , sebagai karakter kelanjutan garis untuk shell bash. Ganti atau hapus karakter ini, tergantung pada persyaratan sistem operasi host Anda. Misalnya, karakter kelanjutan baris untuk windows adalah tanda sisipan, ^. Ganti garis miring terbalik dengan tanda sisipan.
  • Urutan argumen: Jangan ubah urutan argumen kecuali Anda sangat familier dengan kontainer Docker.

Ganti nilai dalam tanda kurung, {}, dengan nilai Anda sendiri:

Tempat penampung Nilai Format atau contoh
{API_KEY} Kunci titik akhir sumber daya Anomaly Detector di halaman Kunci Anomaly Detector Azure. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
{ENDPOINT_URI} Nilai titik akhir tagihan tersedia di halaman Gambaran Umum Anomaly Detector Azure. Lihat mengumpulkan parameter yang diperlukan untuk contoh eksplisit.

Catatan

Sumber daya baru yang dibuat setelah 1 Juli 2019, akan menggunakan nama subdomain kustom. Untuk informasi selengkapnya dan daftar lengkap titik akhir wilayah, lihat Nama subdomain kustom untuk Cognitive Services.

Penting

Opsi Eula, Billing, dan ApiKey harus ditentukan untuk menjalankan kontainer; jika tidak, kontainer tidak akan dimulai. Untuk informasi selengkapnya, lihat Tagihan. Nilai ApiKey adalah Kunci dari halaman kunci Azure Detektor Anomali Resource.

Contoh Docker kontainer Detektor Anomali

Contoh Docker berikut adalah untuk kontainer Detektor Anomali.

Contoh dasar

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
mcr.microsoft.com/azure-cognitive-services/decision/anomaly-detector \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY} 

Contoh pengelogan dengan argumen baris perintah

docker run --rm -it -p 5000:5000 --memory 4g --cpus 1 \
mcr.microsoft.com/azure-cognitive-services/decision/anomaly-detector \
Eula=accept \
Billing={ENDPOINT_URI} ApiKey={API_KEY} \
Logging:Console:LogLevel:Default=Information

Langkah berikutnya