Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Berlaku pada: Azure Logic Apps (Standar)
Panduan ini menjelaskan cara mengelola pengaturan runtime dan lingkungan untuk Standard logic apps di Azure Logic Apps single-tenant.
Pengaturan aplikasi untuk aplikasi logika Standar menentukan opsi konfigurasi global yang memengaruhi semua alur kerja di aplikasi logika tersebut. Namun, pengaturan ini hanya berlaku saat alur kerja ini berjalan di lingkungan pengembangan lokal Anda. Alur kerja yang berjalan secara lokal dapat mengakses pengaturan aplikasi ini sebagai variabel lingkungan lokal, yang digunakan oleh alat pengembangan lokal untuk nilai yang sering kali dapat berubah di antara lingkungan. Misalnya, nilai-nilai tersebut dapat berisi string koneksi. Saat Anda menyebarkan ke Azure, pengaturan aplikasi diabaikan dan tidak disertakan dengan penyebaran Anda.
Aplikasi logika Anda juga memiliki pengaturan host, yang menentukan pengaturan konfigurasi runtime dan nilai yang berlaku untuk semua alur kerja di aplikasi logika tersebut, misalnya, nilai default untuk throughput, kapasitas, ukuran data, dan sebagainya, baik berjalan secara lokal atau di Azure.
Pengaturan adalah pasangan kunci-nilai yang menentukan nama dan nilai pengaturan.
Pengaturan, parameter, dan penyebaran aplikasi
Di Azure Logic Apps multitenant, pengembangan bergantung pada templat Azure Resource Manager (templat ARM), yang menggabungkan dan menangani provisi sumber daya untuk aplikasi logika dan infrastruktur. Desain ini menimbulkan tantangan saat Anda harus mempertahankan variabel lingkungan untuk aplikasi logika di berbagai lingkungan pengembangan, pengujian, dan produksi. Semua yang ada dalam templat ARM ditentukan saat penyebaran. Jika Anda hanya perlu mengubah satu variabel, Anda harus menyebarkan ulang semuanya.
Di Azure Logic Apps tenant tunggal, penyebaran menjadi lebih mudah karena Anda dapat memisahkan penyediaan sumber daya antara aplikasi dan infrastruktur. Anda dapat menggunakan parameter untuk mengabstraksi nilai yang mungkin berubah di antara lingkungan. Dengan menentukan parameter yang akan digunakan dalam alur kerja, Anda dapat terlebih dahulu fokus pada mendesain alur kerja Anda, lalu menyisipkan variabel khusus lingkungan Anda nanti. Anda dapat memanggil dan mereferensikan variabel lingkungan Anda saat runtime dengan menggunakan pengaturan dan parameter aplikasi. Dengan begitu, Anda tidak perlu menyebarkan ulang sesering itu.
Pengaturan aplikasi terintegrasi dengan Azure Key Vault. Anda dapat langsung mereferensikan string aman, seperti kunci dan string koneksi. Mirip dengan templat ARM, tempat Anda dapat menentukan variabel lingkungan pada waktu penyebaran, Anda dapat menentukan pengaturan aplikasi dalam definisi alur kerja aplikasi logika Anda. Anda kemudian dapat mengambil nilai infrastruktur yang dihasilkan secara dinamis, seperti titik akhir koneksi, string penyimpanan, dan banyak lagi. Namun, pengaturan aplikasi memiliki batasan ukuran dan tidak dapat direferensikan dari area tertentu di Azure Logic Apps.
Note
Jika Anda menggunakan Azure Key Vault, pastikan untuk hanya menyimpan rahasia, seperti kata sandi, kredensial, dan sertifikat. Jangan gunakan brankas kunci dalam alur kerja aplikasi logika untuk menyimpan nilai yang bukan rahasia, seperti jalur URL, yang diperlukan oleh perancang alur kerja untuk melakukan panggilan. Perancang tidak dapat mendereferensikan pengaturan aplikasi yang mereferensikan sumber daya Azure Key Vault, yang menghasilkan kesalahan dan panggilan yang gagal. Untuk nilai nonsecret, simpan langsung di pengaturan aplikasi.
Untuk informasi selengkapnya tentang menyiapkan aplikasi logika untuk penyebaran, lihat dokumentasi berikut ini:
- Membuat parameter lintas lingkungan untuk input alur kerja di Azure Logic Apps
- Ikhtisar implementasi DevOps untuk aplikasi logik berbasis tenant tunggal
- Menyiapkan penyebaran Azure DevOps untuk aplikasi logika berbasis penyewa tunggal
Struktur proyek Visual Studio Code
Dalam Visual Studio Code, proyek aplikasi logika Anda memiliki salah satu dari jenis berikut:
- Berbasis bundel ekstensi (Node.js), yang merupakan jenis default
- Berbasis paket NuGet (.NET), yang dapat Anda konversi dari jenis default
Berdasarkan jenis ini, proyek Anda mungkin menyertakan folder atau file yang sedikit berbeda. Misalnya, proyek berbasis paket Nuget memiliki folder .bin yang berisi paket dan file pustaka lainnya. Proyek berbasis bundel ekstensi tidak menyertakan folder .bin ini.
Beberapa skenario memerlukan proyek berbasis paket NuGet agar aplikasi Anda berjalan, misalnya, saat Anda ingin mengembangkan dan menjalankan operasi bawaan kustom. Untuk informasi selengkapnya tentang mengonversi proyek Anda untuk menggunakan NuGet, tinjau Mengaktifkan penulisan konektor bawaan.
Proyek berbasis bundel ekstensi default memiliki folder dan struktur file yang mirip dengan contoh berikut:
MyWorkspaceName
| MyBundleBasedLogicAppProjectName
|| .vscode
|| Artifacts
||| Maps
|||| MapName1
|||| ...
||| Rules
||| Schemas
|||| SchemaName1
|||| ...
|| lib
||| builtinOperationSdks
|||| JAR
|||| net472
||| custom
|| WorkflowName1
||| workflow.json
||| ...
|| WorkflowName2
||| workflow.json
||| ...
|| workflow-designtime
||| host.json
||| local.settings.json
|| .funcignore
|| connections.json
|| host.json
|| local.settings.json
Di tingkat akar proyek, Anda dapat menemukan folder dan file berikut bersama dengan item lain:
| Name | Folder atau file | Description |
|---|---|---|
| .vscode | Folder | Berisi pengaturan terkait Visual Studio Code, seperti file extensions.json, launch.json, settings.json, dan tasks.json files. |
| Artifacts | Folder | Berisi artefak akun integrasi yang Anda tentukan dan gunakan dalam alur kerja yang mendukung skenario business-to-business (B2B). Misalnya, struktur sampel menyertakan folder berikut: - Peta: Berisi peta yang akan digunakan untuk operasi transformasi XML. - Skema: Berisi skema yang akan digunakan untuk operasi validasi XML. - Aturan: Artefak untuk aturan bisnis dalam proyek mesin berbasis aturan. |
| lib | Folder | Berisi rakitan yang didukung yang dapat digunakan atau dirujuk oleh aplikasi logika Anda. Anda dapat mengunggah rakitan ini ke proyek Anda di Visual Studio Code, tetapi Anda harus menambahkannya ke folder tertentu dalam proyek Anda. Misalnya, folder ini menyertakan folder berikut: - builtinOperationSdks: Berisi folder JAR dan net472 untuk rakitan Java dan .NET Framework. - kustom: Berisi komponen kustom .NET Framework. Untuk informasi selengkapnya tentang jenis rakitan yang didukung dan tempat meletakkannya di proyek Anda, lihat Menambahkan rakitan ke proyek Anda. |
| < WorkflowName> | Folder | Untuk setiap alur kerja, folder <WorkflowName> menyertakan file workflow.json, yang berisi definisi JSON yang mendasari alur kerja tersebut. |
| workflow-designtime | Folder | Berisi file pengaturan terkait lingkungan pengembangan. |
| .funcignore | File | Berisi informasi yang terkait dengan Alat Inti Azure Functions yang Anda pasang. |
| connections.json | File | Berisi metadata, titik akhir, dan kunci untuk sambungan terkelola dan fungsi Azure yang digunakan alur kerja Anda. Penting: Untuk menggunakan sambungan dan fungsi yang berbeda untuk setiap lingkungan, pastikan Anda membuat parameter file connections.json ini dan memperbarui titik akhir. |
| host.json | File | Berisi pengaturan dan nilai konfigurasi yang spesifik untuk runtime, misalnya, batas-batas default untuk platform Azure Logic Apps berbasis single-tenant, aplikasi logika, alur kerja, pemicu, dan tindakan. Pada tingkat akar proyek aplikasi logika Anda, file metadata host.json berisi pengaturan konfigurasi dan nilai default yang semua alur kerja dalam aplikasi logika yang sama digunakan saat berjalan, baik secara lokal maupun di Azure. Untuk informasi referensi, lihat Mengedit pengaturan aplikasi dan pengaturan host. Catatan: Saat membuat aplikasi logika, Visual Studio Code akan membuat file host.snapshot.*.json cadangan di kontainer penyimpanan Anda. Jika Anda menghapus aplikasi logika Anda, file cadangan ini tidak dihapus. Jika Anda membuat aplikasi logika lain dengan nama yang sama, file rekam jepret lain dibuat. Anda hanya dapat memiliki hingga 10 rekam jepret untuk aplikasi logika yang sama. Jika Anda melebihi batas ini, Anda akan mendapatkan kesalahan berikut: Microsoft.Azure.WebJobs.Script.WebHost: Repository has more than 10 non-decryptable secrets backups (host)) Untuk mengatasi kesalahan ini, hapus file rekam jepret tambahan dari kontainer penyimpanan Anda. |
| local.settings.json | File | Berisi pengaturan aplikasi, string sambungan, dan pengaturan lain yang digunakan alur kerja Anda saat berjalan secara lokal. Pengaturan dan nilai ini hanya berlaku saat Anda menjalankan proyek di lingkungan pengembangan lokal Anda. Selama penyebaran ke Azure, file dan pengaturan yang terkait diabaikan dan tidak termasuk dalam penyebaran tersebut. File ini menyimpan pengaturan dan nilai sebagai variabel lingkungan lokal yang digunakan alat pengembangan lokal Anda untuk appSettings nilai. Anda dapat memanggil dan merujuk variabel lingkungan ini pada runtime dan waktu penyebaran dengan menggunakan pengaturan aplikasi dan parameter. Penting: File local.settings.json dapat berisi rahasia, jadi pastikan Anda juga mengecualikan file ini dari kontrol sumber proyek. File ini juga berisi pengaturan aplikasi yang perlu berfungsi dengan benar oleh aplikasi logika Anda. Untuk informasi referensi, lihat Mengedit pengaturan aplikasi dan pengaturan host. |
Referensi untuk pengaturan aplikasi - local.settings.json
Di Visual Studio Code, di tingkat akar proyek aplikasi logika Anda, file local.settings.json berisi opsi konfigurasi global yang memengaruhi semua alur kerja di aplikasi logika tersebut saat berjalan di lingkungan pengembangan lokal Anda. Saat alur kerja Anda berjalan secara lokal, pengaturan tersebut diakses sebagai variabel lingkungan lokal, dan nilainya sering kali dapat berubah antar berbagai lingkungan tempat Anda menjalankan alur kerja Anda. Untuk mempelajari cara melihat dan mengelola pengaturan ini, lihat Mengelola pengaturan aplikasi - local.settings.json.
Pengaturan aplikasi di Azure Logic Apps bekerja mirip dengan pengaturan aplikasi di Azure Functions atau Azure Web Apps. Jika Anda pernah menggunakan layanan lain tersebut sebelumnya, Anda mungkin sudah terbiasa dengan pengaturan aplikasi. Untuk informasi selengkapnya, lihat Referensi pengaturan aplikasi untuk Azure Functions dan Bekerja dengan Azure Functions Core Tools - File pengaturan lokal.
Tabel berikut menjelaskan pengaturan aplikasi yang digunakan aplikasi logika Anda. Beberapa pengaturan diperlukan agar aplikasi logika Anda berfungsi dengan benar:
| Setting | Required | Value | Description |
|---|---|---|---|
APP_KIND |
Yes | workflowApp |
Diperlukan untuk mengatur jenis aplikasi untuk sumber daya aplikasi logika Standar. Nilai harus diatur ke workflowApp. Catatan: Dalam beberapa skenario, pengaturan aplikasi ini mungkin hilang, misalnya, karena otomatisasi menggunakan templat Azure Resource Manager atau skenario lain di mana pengaturan tidak disertakan. Jika tindakan tertentu tidak berfungsi, seperti tindakan Jalankan Kode JavaScript, atau jika alur kerja berhenti berfungsi, periksa apakah pengaturan aplikasi APP_KIND ada dan diatur ke workflowApp. |
AZURE_AUTHORITY_HOST |
No | None | Mengatur otoritas default aplikasi logika Standar untuk digunakan untuk autentikasi OAuth. |
AzureWebJobsStorage |
Yes | None | Diperlukan untuk mengatur string koneksi untuk akun penyimpanan Azure. Untuk informasi selengkapnya, lihat AzureWebJobsStorage. |
FUNCTIONS_EXTENSION_VERSION |
Yes | ~4 |
Diperlukan untuk mengatur versi Azure Functions. Untuk informasi selengkapnya, lihat FUNCTIONS_EXTENSION_VERSION. |
FUNCTIONS_WORKER_RUNTIME |
Yes | dotnet |
Diperlukan untuk mengatur runtime pekerja bahasa untuk sumber daya dan alur kerja aplikasi logika Anda. Catatan: Nilai pengaturan ini sebelumnya diatur ke node, tetapi sekarang nilai yang diperlukan adalah dotnet untuk semua aplikasi logika Standar baru dan yang sudah ada yang disebarkan. Perubahan ini seharusnya tidak memengaruhi runtime alur kerja Anda, sehingga semuanya harus berfungsi dengan cara yang sama seperti sebelumnya. Untuk informasi selengkapnya, lihat FUNCTIONS_WORKER_RUNTIME. |
ServiceProviders.Sftp.FileUploadBufferTimeForTrigger |
No | 00:00:20 (20 detik) |
Mengatur waktu buffer untuk mengabaikan file yang memiliki tanda waktu terakhir yang dimodifikasi yang lebih besar dari waktu saat ini. Pengaturan ini berguna ketika penulisan file besar membutuhkan waktu lama dan menghindari pengambilan data untuk file yang ditulis sebagian. |
ServiceProviders.Sftp.OperationTimeout |
No | 00:02:00 (2 menit) |
Mengatur waktu untuk menunggu sebelum kehabisan waktu pada operasi apa pun. |
ServiceProviders.Sftp.ServerAliveInterval |
No | 00:30:00 (30 menit) |
Mengirim pesan tetap hidup untuk menjaga koneksi SSH tetap aktif jika tidak ada pertukaran data dengan server yang terjadi selama periode yang ditentukan. |
ServiceProviders.Sftp.SftpConnectionPoolSize |
No |
2 Koneksi |
Mengatur jumlah koneksi yang dapat di-cache oleh setiap prosesor. Jumlah total koneksi yang dapat Anda cache adalah ProcessorCount dikalikan dengan nilai pengaturan. |
ServiceProviders.MaximumAllowedTriggerStateSizeInKB |
No |
10 KB, yaitu ~1.000 file |
Mengatur ukuran entitas status pemicu dalam kilobyte, yang sebanding dengan jumlah file di folder yang dipantau dan digunakan untuk mendeteksi file. Jika jumlah file melebihi 1.000, tingkatkan nilai ini. |
ServiceProviders.Sql.QueryTimeout |
No | 00:02:00 (2 menit) |
Mengatur nilai batas waktu permintaan untuk operasi penyedia layanan SQL. |
WEBSITE_CONTENTSHARE |
Yes | Dynamic | Diperlukan untuk mengatur nama untuk berkas berbagi yang digunakan Azure Functions untuk menyimpan fungsi aplikasi dan file konfigurasi, serta digunakan bersama WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Defaultnya adalah string unik yang dihasilkan oleh runtime. Untuk informasi selengkapnya, lihat WEBSITE_CONTENTSHARE. |
WEBSITE_LOAD_ROOT_CERTIFICATES |
No | None | Mengatur thumbprint agar sertifikat akar dapat dipercaya. |
WEBSITE_NODE_DEFAULT_VERSION |
Yes | ~ < versi> | Mengatur versi Node.js saat menjalankan alur kerja aplikasi logika Anda di Windows. Gunakan tilde (~) agar runtime Azure Logic Apps menggunakan versi terbaru yang tersedia dari versi utama yang ditargetkan. Misalnya, jika diatur ke ~18, versi terbaru Node.js 18 digunakan. Saat Anda menggunakan tilde dengan versi utama, Anda tidak perlu memperbarui versi minor secara manual. Untuk informasi selengkapnya, lihat WEBSITE_NODE_DEFAULT_VERSION. |
Workflows.Connection.AuthenticationAudience |
No | None | Mengatur audiens untuk mengautentikasi koneksi terkelola (yang dihosting Azure). |
Workflows.CustomHostName |
No | None | Mengatur nama host yang akan digunakan untuk workflow dan URL input-output, misalnya, logic.contoso.com. Untuk informasi tentang mengonfigurasi nama DNS kustom, lihat Menyiapkan domain kustom yang sudah ada di Azure App Service dan Mengaktifkan HTTPS untuk domain kustom di Azure App Service. |
Workflows.<workflowName>.FlowState |
No | None | Mengatur status untuk <workflowName>. |
Workflows.<workflowName>.RuntimeConfiguration.RetentionInDays |
No |
90 hari |
Mengatur jumlah waktu dalam hari untuk menyimpan riwayat eksekusi untuk <workflowName>. - Minimum: 7 hari - Maksimum: 365 hari |
Workflows.RuntimeConfiguration.RetentionInDays |
No |
90 hari |
Mengatur jumlah hari untuk mempertahankan riwayat eksekusi alur kerja setelah dijalankan. - Minimum: 7 hari - Maksimum: 365 hari |
Workflows.WebhookRedirectHostUri |
No | None | Mengatur nama host yang akan digunakan untuk URL panggilan balik webhook. |
Mengelola pengaturan aplikasi - local.settings.json
Untuk menambahkan, memperbarui, atau menghapus pengaturan aplikasi, pilih dan tinjau bagian berikut untuk portal Microsoft Azure, Visual Studio Code, atau Azure CLI. Untuk pengaturan aplikasi khusus untuk aplikasi logika, lihat Referensi untuk pengaturan aplikasi - local.settings.json.
Menampilkan pengaturan aplikasi di portal
Di kotak pencarian portal Microsoft Azure , temukan dan buka aplikasi logika Anda.
Pada menu bilah samping, di bawah Pengaturan, pilih Variabel lingkungan.
Pada halaman Variabel lingkungan , pada tab Pengaturan aplikasi , tinjau pengaturan aplikasi untuk aplikasi logika Anda.
Untuk informasi selengkapnya tentang pengaturan ini, lihat Referensi untuk pengaturan aplikasi - local.settings.json.
Untuk menampilkan semua nilai, pada toolbar halaman, pilih Perlihatkan Nilai. Atau, untuk melihat satu nilai, di kolom Nilai , pilih Perlihatkan nilai (ikon mata).
Menambahkan pengaturan aplikasi di portal
Pada tab Pengaturan aplikasi , pada toolbar, pilih Tambahkan.
Pada panel Tambahkan/Edit pengaturan aplikasi, untuk Nama, masukkan kunci atau nama untuk pengaturan baru Anda.
Untuk Nilai, masukkan nilai untuk pengaturan baru Anda.
Jika sudah selesai, pilih Terapkan.
Referensi untuk pengaturan host - host.json
Di Visual Studio Code, di tingkat akar proyek aplikasi logika Anda, file metadata host.json berisi pengaturan runtime dan nilai default yang berlaku untuk semua alur kerja dalam sumber daya aplikasi logika baik berjalan secara lokal atau di Azure. Untuk mempelajari cara melihat dan mengelola pengaturan ini, lihat Mengelola pengaturan host - host.json. Anda juga dapat menemukan informasi batas terkait di dokumentasi Batas dan konfigurasi untuk Azure Logic Apps.
Throughput orkestrasi pekerjaan
Pengaturan ini memengaruhi throughput dan kapasitas untuk Azure Logic Apps dengan penyewa tunggal dalam menjalankan operasi alur kerja.
| Setting | Nilai standar | Description |
|---|---|---|
Jobs.BackgroundJobs.DispatchingWorkersPulseInterval |
00:00:01 (1 detik) |
Mengatur interval bagi dispatcher pekerjaan untuk memeriksa antrean pekerjaan ketika pemeriksaan sebelumnya tidak menemukan pekerjaan. Dispatcher pekerjaan memeriksa antrean segera setelah pemeriksaan sebelumnya mengembalikan pekerjaan. |
Jobs.BackgroundJobs.NumPartitionsInJobDefinitionsTable |
4 partisi pekerjaan |
Mengatur jumlah partisi pekerjaan dalam tabel definisi pekerjaan. Nilai ini mengontrol berapa banyak throughput eksekusi yang dipengaruhi oleh batas penyimpanan partisi. |
Jobs.BackgroundJobs.NumPartitionsInJobTriggersQueue |
1 antrian pekerjaan |
Mengatur jumlah antrean pekerjaan yang dipantau oleh dispatcher pekerjaan untuk pekerjaan yang akan diproses. Nilai ini juga memengaruhi jumlah partisi penyimpanan tempat antrean pekerjaan berada. |
Jobs.BackgroundJobs.NumWorkersPerProcessorCount |
192 instans pekerja pengatur tugas |
Mengatur jumlah instans pekerja dispatcher atau penjadwal pekerjaan per inti prosesor. Nilai ini memengaruhi jumlah alur kerja yang berjalan per inti. |
Jobs.BackgroundJobs.StatelessNumWorkersPerProcessorCount |
192 instans pekerja dispatcher |
Mengatur jumlah instans pekerja dispatcher atau dispatcher pekerjaan untuk memiliki per inti prosesor, per eksekusi tanpa status. Nilai ini memengaruhi jumlah tindakan alur kerja bersamaan yang diproses per eksekusi. |
Pengaturan berikut digunakan untuk menghentikan secara manual dan segera menghapus alur kerja yang ditentukan di aplikasi logika Standar.
Note
Gunakan pengaturan ini dengan hati-hati dan hanya di lingkungan nonproduksi, seperti lingkungan uji beban atau performa, karena Anda tidak dapat membatalkan atau memulihkan dari operasi ini.
| Setting | Nilai standar | Description |
|---|---|---|
Jobs.CleanupJobPartition |
None | Segera menghapus semua pekerjaan eksekusi untuk alur kerja yang ditentukan. |
Jobs.SuspendedJobPartition |
None | Menghentikan pekerjaan yang berjalan untuk alur kerja yang ditentukan. |
SequencerJobs.SuspendedSequencerPartition |
None | Menghentikan tugas menjalankan pada penyusun urutan dari alur kerja yang ditentukan. |
Untuk menentukan alur kerja individual, gunakan sintaks berikut di mana setiap ID alur kerja diikuti oleh titik dua (:) dan dipisahkan oleh titik koma (;):
"Jobs.CleanupJobPartition": "<workflow-ID-1>:;<workflow-ID-2>",
"Jobs.SuspendedJobPartition": "<workflow-ID-1>:;<workflow-ID-2>:",
"SequencerJobs.SuspendedSequencerPartition": "<workflow-ID-1>:;<workflow-ID-2>:"
Untuk membatalkan eksekusi tertentu, berikan ID eksekusi setelah ID alur kerja dengan 2D sebagai pemisah, misalnya:
"Jobs.SuspendedJobPartition": "<workflow-ID-1>:2D<run-ID>;",
Pemicu berbasis pengulangan
| Setting | Nilai standar | Description |
|---|---|---|
Microsoft.Azure.Workflows.ServiceProviders.MaximumAllowedTriggerStateSizeInKB |
1 KB |
Mengatur ukuran maksimum yang diizinkan status pemicu untuk pemicu berbasis pengulangan seperti pemicu SFTP bawaan. Status pemicu menyimpan data di beberapa pemicu berulang dari penyedia layanan. Penting: Berdasarkan ukuran penyimpanan Anda, hindari pengaturan nilai ini terlalu tinggi, yang dapat berdampak buruk pada penyimpanan dan performa. |
Memicu konkurensi
Pengaturan konkurensi berikut hanya berlaku untuk alur kerja yang dimulai dengan pemicu berbasis pengulangan untuk konektor berbasis penyedia layanan bawaan dan mengontrol jumlah alur kerja yang berjalan bersamaan, atau pada saat yang sama.
Untuk alur kerja yang dimulai dengan pemicu berbasis fungsi, Anda mungkin mencoba menyiapkan batching jika didukung. Namun, batching tidak selalu menjadi solusi yang benar. Misalnya, dengan pemicu Azure Service Bus, batch mungkin menyimpan pesan melebihi durasi penguncian. Akibatnya, tindakan apa pun, seperti selesai atau abaikan, gagal pada pesan tersebut.
| Setting | Nilai standar | Description |
|---|---|---|
Runtime.Trigger.MaximumRunConcurrency |
100 eksekusi |
Mengatur jumlah maksimum eksekusi serentak yang dapat dimulai oleh pemicu. Nilai ini muncul dalam definisi keserentakan pemicu. |
Runtime.Trigger.MaximumWaitingRuns |
200 menjalankan |
Mengatur jumlah maksimum run yang dapat menunggu setelah run serentak mencapai batas maksimum. Nilai ini muncul dalam definisi konkurensi pemicu. Untuk informasi selengkapnya, lihat Mengubah batas antrian eksekusi. |
Durasi pelaksanaan dan retensi riwayat
| Setting | Nilai standar | Description |
|---|---|---|
Runtime.Backend.FlowRunTimeout |
90.00:00:00 (90 hari) |
Mengatur jumlah waktu alur kerja dapat terus berjalan sebelum memaksa batas waktu. Nilai minimum untuk pengaturan ini adalah 7 hari. Penting: Pastikan nilai ini kurang dari atau sama dengan nilai untuk pengaturan aplikasi bernama Workflows.RuntimeConfiguration.RetentionInDays. Jika tidak, riwayat eksekusi dapat dihapus sebelum tugas terkait selesai. |
Runtime.FlowMaintenanceJob.RetentionCooldownInterval |
7.00:00:00 (7 hari) |
Mengatur jumlah waktu dalam hari sebagai interval antara kapan harus memeriksa dan menghapus riwayat eksekusi yang tidak ingin Anda simpan lagi. |
Jalankan tindakan
| Setting | Nilai standar | Description |
|---|---|---|
Runtime.FlowRunRetryableActionJobCallback.ActionJobExecutionTimeout |
00:10:00 (10 menit) |
Mengatur durasi untuk aksi alur kerja yang akan dijalankan sebelum habis waktu dan mencoba kembali. Durasi maksimum adalah 2 jam (02:00:00). Untuk mengubah batas waktu default untuk operasi bawaan seperti SAP, Anda juga harus mengatur pengaturan host functionTimeout. Untuk informasi selengkapnya, lihat entri berikutnya. |
functionTimeout |
00:30:00 (30 menit) |
Mengatur durasi untuk dijalankan sebelum waktu habis untuk panggilan dari Azure Functions dan beberapa operasi bawaan, seperti SAP, yang berfungsi sebagai panggilan fungsi. Aplikasi logika standar menggunakan desain yang mendasar yang sama dengan aplikasi fungsi. Jadi, pengaturan host functionTimeout di Azure Functions juga memengaruhi operasi bawaan yang dijalankan sebagai panggilan fungsi. Untuk informasi selengkapnya, lihat functionTimeout. Catatan: Dalam file host.json, functionTimeout pengaturan tersebut berada pada tingkat yang sama dengan objek tempat pengaturan host ada untuk aplikasi logika Standar. Untuk informasi selengkapnya, lihat contoh di bagian ini: Mengubah nilai batas waktu untuk operasi bawaan berbasis fungsi. |
Mengubah nilai batas waktu untuk operasi bawaan berbasis fungsi
Untuk operasi bawaan yang berjalan sebagai panggilan fungsi di Azure Functions, tambahkan kedua pengaturan Runtime.FlowRunRetryableActionJobCallback.ActionJobExecutionTimeout dan functionTimeout ke file host.json Anda seperti yang ditunjukkan dalam contoh berikut:
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Workflows",
"version": "[1.*, 2.0.0)"
},
"extensions": {
"workflow": {
"Settings": {
"Runtime.FlowRunRetryableActionJobCallback.ActionJobExecutionTimeout": "01:00:00"
}
}
},
"functionTimeout": "01:00:00"
}
Input dan output
| Setting | Nilai standar | Description |
|---|---|---|
Microsoft.Azure.Workflows.TemplateLimits.InputParametersLimit |
50 |
Mengubah batas default pada parameter alur kerja lintas lingkungan hingga 500 untuk aplikasi logika Standar yang dibuat dengan mengekspor aplikasi logika Konsumsi. |
Runtime.ContentLink.MaximumContentSizeInBytes |
104857600 byte |
Mengatur ukuran maksimum dalam byte yang dapat dimiliki input atau output dalam satu pemicu atau tindakan. |
Runtime.FlowRunActionJob.MaximumActionResultSize |
209715200 byte |
Mengatur ukuran maksimum dalam byte yang dapat dimiliki input dan output gabungan dalam satu tindakan. |
Pagination
| Setting | Nilai standar | Description |
|---|---|---|
Runtime.FlowRunRetryableActionJobCallback.MaximumPageCount |
1000 halaman |
Ketika paginasi didukung dan diaktifkan pada suatu operasi, menetapkan jumlah maksimum halaman untuk dikembalikan atau diproses saat runtime. |
Chunking
| Setting | Nilai standar | Description |
|---|---|---|
Runtime.FlowRunRetryableActionJobCallback.MaximumContentLengthInBytesForPartialContent |
1073741824 byte |
Saat chunking didukung dan diaktifkan pada suatu operasi, mengatur ukuran maksimum dalam byte untuk konten yang diunduh atau diunggah. |
Runtime.FlowRunRetryableActionJobCallback.MaxChunkSizeInBytes |
52428800 byte |
Saat pengelompokan didukung dan diaktifkan pada suatu operasi, mengatur ukuran maksimum dalam byte untuk setiap kelompok konten. |
Runtime.FlowRunRetryableActionJobCallback.MaximumRequestCountForPartialContent |
1000 permintaan |
Saat chunking didukung dan diaktifkan pada suatu operasi, mengatur jumlah maksimum permintaan yang dapat dilakukan oleh eksekusi tindakan untuk mengunduh konten. |
Menyimpan konten sebaris atau menggunakan blob
| Setting | Nilai standar | Description |
|---|---|---|
Runtime.FlowRunEngine.ForeachMaximumItemsForContentInlining |
20 item |
Saat perulangan For each berjalan, nilai setiap item disimpan sebaris dengan metadata lain di penyimpanan tabel atau secara terpisah di penyimpanan blob. Mengatur jumlah item untuk disimpan sebaris dengan metadata lainnya. |
Runtime.FlowRunRetryableActionJobCallback.MaximumPagesForContentInlining |
20 halaman |
Mengatur jumlah halaman maksimum untuk disimpan sebagai konten sebaris dalam penyimpanan tabel sebelum disimpan dalam penyimpanan blob. |
Runtime.FlowTriggerSplitOnJob.MaximumItemsForContentInlining |
40 item |
Saat pemicu yang mendukung debatching memiliki pengaturan Pemisahan atau splitOn diaktifkan, pemicu akan membagi item array ke dalam beberapa instans alur kerja. Setiap nilai item array disimpan sebaris dengan metadata lain dalam penyimpanan tabel atau secara terpisah dalam penyimpanan blob. Mengatur jumlah item untuk disimpan sebaris. |
Runtime.ScaleUnit.MaximumCharactersForContentInlining |
32384 karakter |
Mengatur jumlah maksimum karakter masukan dan keluaran operasi untuk disimpan secara langsung dalam penyimpanan tabel sebelum disimpan dalam penyimpanan blob. |
Perulangan Untuk Setiap
| Setting | Nilai standar | Description |
|---|---|---|
Runtime.Backend.FlowDefaultForeachItemsLimit |
100000 elemen array |
Untuk alur kerja stateful, tetapkan jumlah maksimum item array yang akan diproses dalam sebuah For each perulangan. |
Runtime.Backend.FlowDefaultSplitOnItemsLimit |
100000 elemen array |
Mengatur jumlah maksimum item array untuk diproses atau dibagi menjadi beberapa instans alur kerja berdasarkan properti splitOn tersebut. |
Runtime.Backend.ForeachDefaultDegreeOfParallelism |
20 perulangan |
Mengatur jumlah default perulangan serentak, atau derajat paralelisme, dalam perulangan For each. Untuk menjalankan secara berurutan, atur nilainya ke 1. |
Runtime.Backend.Stateless.FlowDefaultForeachItemsLimit |
100 item |
Untuk alur kerja tanpa status, mengatur jumlah maksimum item array untuk diproses dalam perulangan For each . |
Sampai perulangan
| Setting | Nilai standar | Description |
|---|---|---|
Runtime.Backend.MaximumUntilLimitCount |
5000 perulangan |
Untuk alur kerja stateful, mengatur jumlah maksimum yang dapat ditetapkan untuk properti Count di tindakan Until. |
Runtime.Backend.Stateless.FlowRunTimeout |
00:05:00 (5 menit) |
Mengatur waktu tunggu maksimum untuk perulangan Until dalam alur kerja tanpa status. |
Runtime.Backend.Stateless.MaximumUntilLimitCount |
100 perulangan |
Untuk alur kerja tanpa status, menetapkan jumlah maksimum yang mungkin untuk properti Count dalam tindakan Until. |
Variables
| Setting | Nilai standar | Description |
|---|---|---|
Runtime.Backend.DefaultAppendArrayItemsLimit |
100000 item array |
Mengatur jumlah maksimum item dalam variabel dengan jenis Array. |
Runtime.Backend.VariableOperation.MaximumStatelessVariableSize |
Alur kerja tanpa status: 1024 karakter |
Mengatur ukuran maksimum dalam karakter untuk konten yang dapat disimpan oleh variabel saat digunakan di alur kerja tanpa status. |
Runtime.Backend.VariableOperation.MaximumVariableSize |
Alur kerja berstatus: 104857600 karakter |
Mengatur ukuran maksimum dalam karakter untuk konten yang dapat disimpan oleh variabel saat digunakan di alur kerja berstatus. |
Operasi HTTP bawaan
| Setting | Nilai standar | Description |
|---|---|---|
Runtime.Backend.HttpOperation.DefaultRetryCount |
4 percobaan ulang |
Mengatur jumlah percobaan ulang bawaan untuk pemicu dan aksi HTTP. |
Runtime.Backend.HttpOperation.DefaultRetryInterval |
00:00:07 (7 detik) |
Mengatur interval percobaan kembali default untuk tindakan dan pemicu HTTP. |
Runtime.Backend.HttpOperation.DefaultRetryMaximumInterval |
01:00:00 (1 jam) |
Mengatur interval percobaan kembali maksimum untuk pemicu dan tindakan HTTP. |
Runtime.Backend.HttpOperation.DefaultRetryMinimumInterval |
00:00:05 (5 detik) |
Mengatur interval percobaan kembali minimum pada pemicu dan tindakan HTTP. |
Runtime.Backend.HttpOperation.MaxContentSize |
104857600 byte |
Mengatur ukuran permintaan maksimum dalam byte hanya untuk tindakan HTTP, bukan pemicu. Untuk informasi selengkapnya, lihat Batasan. |
Runtime.Backend.HttpOperation.RequestTimeout |
00:03:45 (3 menit dan 45 detik) Catatan: Nilai default juga merupakan nilai maksimum. |
Mengatur nilai batas waktu permintaan untuk tindakan dan pemicu HTTP. |
Operasi HTTP Webhook bawaan
| Setting | Nilai standar | Description |
|---|---|---|
Runtime.Backend.HttpWebhookOperation.DefaultRetryCount |
4 percobaan ulang |
Mengatur jumlah percobaan ulang default untuk pemicu dan tindakan webhook HTTP. |
Runtime.Backend.HttpWebhookOperation.DefaultRetryInterval |
00:00:07 (7 detik) |
Mengatur interval pengulangan default untuk pemicu dan tindakan webhook HTTP. |
Runtime.Backend.HttpWebhookOperation.DefaultRetryMaximumInterval |
01:00:00 (1 jam) |
Mengatur interval percobaan ulang maksimum untuk pemicu dan tindakan webhook HTTP. |
Runtime.Backend.HttpWebhookOperation.DefaultRetryMinimumInterval |
00:00:05 (5 detik) |
Mengatur interval minimum percobaan ulang untuk pemicu dan tindakan webhook HTTP. |
Runtime.Backend.HttpWebhookOperation.DefaultWakeUpInterval |
01:00:00 (1 jam) |
Mengatur interval bangun default untuk pekerjaan pemicu dan aksi webhook HTTP. |
Runtime.Backend.HttpWebhookOperation.MaxContentSize |
104857600 byte |
Mengatur ukuran permintaan maksimum dalam byte hanya untuk tindakan webhook HTTP, bukan pemicu. Untuk informasi selengkapnya, lihat Batasan. |
Runtime.Backend.HttpWebhookOperation.RequestTimeout |
00:02:00 (2 menit) |
Mengatur nilai batas waktu permintaan untuk tindakan dan pemicu webhook HTTP. |
Operasi Azure Storage bawaan
Penyimpanan data Blob
| Setting | Nilai standar | Description |
|---|---|---|
Microsoft.Azure.Workflows.ContentStorage.RequestOptionsThreadCount |
None | Mengatur jumlah utas untuk operasi unggah dan unduh blob. Anda dapat menggunakan pengaturan ini untuk memaksa runtime Azure Logic Apps agar menggunakan beberapa utas saat mengunggah dan mengunduh konten dari tindakan input dan output. |
Runtime.ContentStorage.RequestOptionsDeltaBackoff |
00:00:02 (2 detik) |
Mengatur interval backoff antar percobaan kembali yang dikirim ke penyimpanan blob. |
Runtime.ContentStorage.RequestOptionsMaximumAttempts |
4 percobaan ulang |
Mengatur jumlah maksimum percobaan kembali yang dikirim ke penyimpanan antrean dan tabel. |
Runtime.ContentStorage.RequestOptionsMaximumExecutionTime |
00:02:00 (2 menit) |
Mengatur nilai batas waktu operasi, termasuk percobaan ulang, untuk permintaan blob dari runtime Azure Logic Apps. |
Runtime.ContentStorage.RequestOptionsServerTimeout |
00:00:30 (30 detik) |
Mengatur nilai batas waktu untuk permintaan blob dari Azure Logic Apps runtime. |
Penyimpanan tabel dan antrean
| Setting | Nilai standar | Description |
|---|---|---|
Runtime.DataStorage.RequestOptionsDeltaBackoff |
00:00:02 (2 detik) |
Mengatur interval backoff antar percobaan kembali yang dikirim ke penyimpanan antrean dan tabel. |
Runtime.DataStorage.RequestOptionsMaximumAttempts |
4 upaya ulang |
Mengatur jumlah maksimum percobaan kembali yang dikirim ke penyimpanan antrean dan tabel. |
Runtime.DataStorage.RequestOptionsMaximumExecutionTime |
00:00:45 (45 detik) |
Mengatur nilai batas waktu operasi, termasuk upaya ulang, untuk permintaan penyimpanan tabel dan antrean dari runtime Azure Logic Apps. |
Runtime.DataStorage.RequestOptionsServerTimeout |
00:00:16 (16 detik) |
Mengatur nilai batas waktu untuk permintaan penyimpanan tabel dan antrean dari runtime Azure Logic Apps. |
Pembagian file
| Setting | Nilai standar | Description |
|---|---|---|
ServiceProviders.AzureFile.MaxFileSizeInBytes |
150000000 byte |
Mengatur ukuran file maksimum dalam byte untuk berbagi file Azure. |
Operasi Azure Functions bawaan
| Setting | Nilai standar | Description |
|---|---|---|
Runtime.Backend.FunctionOperation.RequestTimeout |
00:03:45 (3 menit dan 45 detik) |
Mengatur nilai batas waktu permintaan untuk tindakan Azure Functions. |
Runtime.Backend.FunctionOperation.MaxContentSize |
104857600 byte |
Mengatur ukuran permintaan maksimum dalam byte untuk tindakan Azure Functions. Untuk informasi selengkapnya, lihat Batasan. |
Runtime.Backend.FunctionOperation.DefaultRetryCount |
4 pengulangan |
Mengatur pengaturan jumlah maksimal coba ulang default untuk tindakan Azure Functions. |
Runtime.Backend.FunctionOperation.DefaultRetryInterval |
00:00:07 (7 detik) |
Mengatur interval pengulangan kembali default untuk tindakan Azure Functions. |
Runtime.Backend.FunctionOperation.DefaultRetryMaximumInterval |
01:00:00 (1 jam) |
Mengatur interval pengulangan maksimum untuk tindakan Azure Functions. |
Runtime.Backend.FunctionOperation.DefaultRetryMinimumInterval |
00:00:05 (5 detik) |
Mengatur interval upaya ulang minimum untuk tindakan Azure Functions. |
Operasi Azure Service Bus bawaan
| Setting | Nilai standar | Description |
|---|---|---|
ServiceProviders.ServiceBus.MessageSenderOperationTimeout |
00:01:00 (1 menit) |
Atur batas waktu untuk mengirim pesan dengan operasi Service Bus terintegrasi. |
Runtime.ServiceProviders.ServiceBus.MessageSenderPoolSizePerProcessorCount |
64 pengirim pesan |
Mengatur jumlah pengirim pesan Azure Service Bus per inti prosesor untuk digunakan di kumpulan pengirim pesan. |
Operasi SFTP yang terintegrasi secara bawaan
| Setting | Nilai standar | Description |
|---|---|---|
Runtime.ServiceProviders.Sftp.MaxFileSizeInBytes |
2147483648 byte |
Mengatur ukuran maksimum file dalam byte untuk tindakan Get file content (V2). |
Runtime.ServiceProviders.Sftp.MaximumFileSizeToReadInBytes |
209715200 byte |
Mengatur ukuran file maksimum dalam byte untuk tindakan Ambil konten file. Pastikan nilai ini tidak melebihi ukuran memori yang dapat dirujuk karena tindakan ini membaca konten file dalam memori. |
Operasi konektor terkelola
| Setting | Nilai standar | Description |
|---|---|---|
Runtime.Backend.ApiConnectionOperation.RequestTimeout |
00:02:00 (2 menit) |
Mengatur nilai batas waktu permintaan untuk tindakan dan pemicu konektor API terkelola. |
Runtime.Backend.ApiConnectionOperation.MaxContentSize |
104857600 byte |
Mengatur ukuran maksimum permintaan data dalam byte untuk pemicu dan tindakan konektor API yang dikelola. Untuk informasi selengkapnya, lihat Batasan. |
Runtime.Backend.ApiConnectionOperation.DefaultRetryCount |
4 pengulangan |
Mengatur jumlah pengulangan default untuk pemicu dan tindakan konektor API terkelola. |
Runtime.Backend.ApiConnectionOperation.DefaultRetryInterval |
00:00:07 (7 detik) |
Mengatur interval coba ulang default untuk pemicu dan tindakan konektor API terkelola. |
Runtime.Backend.ApiWebhookOperation.DefaultRetryMaximumInterval |
01:00:00 (1 hari) |
Mengatur interval percobaan ulang maksimum untuk pemicu dan tindakan webhook dari konektor API yang dikelola. |
Runtime.Backend.ApiConnectionOperation.DefaultRetryMinimumInterval |
00:00:05 (5 detik) |
Mengatur interval ulang minimum untuk pemicu dan tindakan konektor API terkelola. |
Runtime.Backend.ApiWebhookOperation.DefaultWakeUpInterval |
01:00:00 (1 hari) |
Mengatur interval bangun default untuk pekerjaan pemicu dan tindakan webhook pada konektor API yang dikelola. |
Kebijakan ulang untuk semua operasi lainnya
| Setting | Nilai standar | Description |
|---|---|---|
Runtime.ScaleMonitor.MaxPollingLatency |
00:00:30 (30 detik) |
Mengatur latensi polling maksimum untuk penskalaan runtime. |
Runtime.Backend.Operation.MaximumRetryCount |
90 percobaan ulang |
Mengatur jumlah maksimum pengulangan dalam definisi kebijakan pengulangan untuk operasi pada alur kerja. |
Runtime.Backend.Operation.MaximumRetryInterval |
01:00:00:01 (1 hari dan 1 detik) |
Menetapkan interval maksimum dalam definisi kebijakan coba ulang untuk operasi alur kerja. |
Runtime.Backend.Operation.MinimumRetryInterval |
00:00:05 (5 detik) |
Mengatur interval minimum dalam definisi kebijakan pengulangan untuk operasi alur kerja. |
Limitations
Ukuran konten maksimum:
Secara default, pemicu bawaan, seperti HTTP atau Permintaan, terbatas pada ukuran pesan yang dijelaskan dalam Batas dan referensi konfigurasi - Pesan. Untuk menangani file yang lebih besar dari batas, coba unggah konten Anda sebagai blob ke Azure Blob Storage, lalu dapatkan konten Anda menggunakan konektor Azure Blob.
Mengelola pengaturan host - host.json
Anda dapat menambahkan, memperbarui, atau menghapus pengaturan host, yang menentukan pengaturan konfigurasi runtime dan nilai yang berlaku untuk semua alur kerja dalam aplikasi logika tersebut, seperti nilai default untuk throughput, kapasitas, ukuran data, dan sebagainya, baik dijalankan secara lokal maupun di Azure. Untuk pengaturan host khusus untuk aplikasi logika, lihat Referensi untuk pengaturan host - host.json.
Untuk memeriksa pengaturan host untuk aplikasi logika berbasis single-tenant Anda dalam portal Azure, ikuti langkah-langkah berikut:
Di kotak pencarian portal Microsoft Azure , temukan dan buka aplikasi logika Anda.
Pada menu sumber daya, di bawah Alat Pengembangan, pilih Alat Tingkat Lanjut.
Di panel Alat Tingkat Lanjut, pilih Buka, yang membuka lingkungan Kudu untuk aplikasi logika.
Di toolbar Kudu, buka menu Konsol debug, dan pilih CMD.
Jendela konsol terbuka sehingga Anda dapat menelusuri folder wwwroot menggunakan prompt perintah. Atau, Anda dapat menelusuri struktur direktori yang muncul di atas jendela konsol.
Telusuri di sepanjang jalur berikut ke folder wwwroot :
...\home\site\wwwroot.Di atas jendela konsol, di tabel direktori, di samping file host.json , pilih Edit.
Setelah file host.json terbuka, tinjau pengaturan host apa pun yang sebelumnya ditambahkan untuk aplikasi logika Anda.
Untuk informasi selengkapnya tentang pengaturan host, lihat Referensi untuk pengaturan host - host.json.
Untuk menambahkan pengaturan, ikuti langkah-langkah berikut:
Sebelum Anda menambahkan atau mengedit pengaturan, hentikan aplikasi logika Anda di portal Azure.
Pada menu sumber daya, pilih Gambaran Umum.
Di toolbar panel Gambaran Umum, pilih Hentikan.
Jika file host.json sudah terbuka, kembali ke file host.json . Jika tidak, ikuti langkah-langkah sebelumnya untuk membuka file host.json .
Di bawah objek
extensionBundle, tambahkan objekextensions, yang menyertakan objekworkflowdanSettings, misalnya:{ "version": "2.0", "extensionBundle": { "id": "Microsoft.Azure.Functions.ExtensionBundle", "version": "[1.*, 2.0.0)" }, "extensions": { "workflow": { "Settings": { } } } }Dalam objek
Settings, tambahkan daftar rata dengan pengaturan host yang ingin Anda gunakan untuk semua alur kerja di aplikasi logika Anda, baik alur kerja tersebut berjalan secara lokal maupun di Azure, misalnya:{ "version": "2.0", "extensionBundle": { "id": "Microsoft.Azure.Functions.ExtensionBundle", "version": "[1.*, 2.0.0)" }, "extensions": { "workflow": { "Settings": { "Runtime.Trigger.MaximumWaitingRuns": "100" } } } }Setelah selesai, ingatlah untuk memilih Simpan.
Sekarang, hidupkan ulang aplikasi logika Anda. Kembali ke halaman Gambaran Umum aplikasi logika Anda, dan pilih Mulai ulang.