Referenční informace k host.json pro Azure Functions 1.x

Soubor metadat host.json obsahuje možnosti konfigurace, které ovlivňují všechny funkce v instanci aplikace funkcí. Tento článek uvádí nastavení, která jsou k dispozici pro modul runtime verze 1.x. Schéma JSON je na http://json.schemastore.org/hostadrese .

Poznámka:

Tento článek je určený pro Azure Functions 1.x. Referenční informace o host.json ve funkcích 2.x a novějších najdete v host.json referenčních informacích pro Azure Functions 2.x.

Další možnosti konfigurace aplikace funkcí se spravují v nastavení aplikace.

Některá nastavení host.json se používají jenom při místním spuštění v souboru local.settings.json .

Ukázkový soubor host.json

Následující ukázkové host.json soubory mají zadané všechny možné možnosti.

{
    "aggregator": {
        "batchSize": 1000,
        "flushTimeout": "00:00:30"
    },
    "applicationInsights": {
        "sampling": {
          "isEnabled": true,
          "maxTelemetryItemsPerSecond" : 5
        }
    },
    "documentDB": {
        "connectionMode": "Gateway",
        "protocol": "Https",
        "leaseOptions": {
            "leasePrefix": "prefix"
        }
    },
    "eventHub": {
      "maxBatchSize": 64,
      "prefetchCount": 256,
      "batchCheckpointFrequency": 1
    },
    "functions": [ "QueueProcessor", "GitHubWebHook" ],
    "functionTimeout": "00:05:00",
    "healthMonitor": {
        "enabled": true,
        "healthCheckInterval": "00:00:10",
        "healthCheckWindow": "00:02:00",
        "healthCheckThreshold": 6,
        "counterThreshold": 0.80
    },
    "http": {
        "routePrefix": "api",
        "maxOutstandingRequests": 20,
        "maxConcurrentRequests": 10,
        "dynamicThrottlesEnabled": false
    },
    "id": "9f4ea53c5136457d883d685e57164f08",
    "logger": {
        "categoryFilter": {
            "defaultLevel": "Information",
            "categoryLevels": {
                "Host": "Error",
                "Function": "Error",
                "Host.Aggregator": "Information"
            }
        }
    },
    "queues": {
      "maxPollingInterval": 2000,
      "visibilityTimeout" : "00:00:30",
      "batchSize": 16,
      "maxDequeueCount": 5,
      "newBatchThreshold": 8
    },
    "sendGrid": {
        "from": "Contoso Group <admin@contoso.com>"
    },
    "serviceBus": {
      "maxConcurrentCalls": 16,
      "prefetchCount": 100,
      "autoRenewTimeout": "00:05:00",
      "autoComplete": true
    },
    "singleton": {
      "lockPeriod": "00:00:15",
      "listenerLockPeriod": "00:01:00",
      "listenerLockRecoveryPollingInterval": "00:01:00",
      "lockAcquisitionTimeout": "00:01:00",
      "lockAcquisitionPollingInterval": "00:00:03"
    },
    "tracing": {
      "consoleLevel": "verbose",
      "fileLoggingMode": "debugOnly"
    },
    "watchDirectories": [ "Shared" ],
}

Následující části tohoto článku vysvětlují jednotlivé vlastnosti nejvyšší úrovně. Všechny jsou volitelné, pokud není uvedeno jinak.

agregátor

Určuje, kolik volání funkcí se agreguje při výpočtu metrik pro Application Insights.

{
    "aggregator": {
        "batchSize": 1000,
        "flushTimeout": "00:00:30"
    }
}

Majetek	Výchozí	Popis
velikost dávky	1 000	Maximální počet požadavků, které se mají agregovat.
flushTimeout	00:00:30	Maximální časové období, které se má agregovat.

Vyvolání funkcí se agreguje při dosažení prvního ze dvou limitů.

Přehledy aplikace

Řídí funkci vzorkování v Application Insights.

{
    "applicationInsights": {
        "sampling": {
          "isEnabled": true,
          "maxTelemetryItemsPerSecond" : 5
        }
    }
}

Majetek	Výchozí	Popis
jeAktivováno	pravda	Povolí nebo zakáže vzorkování.
Maximální počet telemetrických položek za sekundu	5	Prahová hodnota, na které začíná vzorkování.

DocumentDB

Nastavení konfigurace služby Azure Cosmos DB pro triggery a vazby.

{
    "documentDB": {
        "connectionMode": "Gateway",
        "protocol": "Https",
        "leaseOptions": {
            "leasePrefix": "prefix1"
        }
    }
}

Majetek	Výchozí	Popis
GatewayMode	Brána	Režim připojení používaný funkcí při připojování ke službě Azure Cosmos DB. Možnosti jsou `Direct` a `Gateway`
Protokol	Https	Protokol připojení používaný funkcí při připojení ke službě Azure Cosmos DB. Tady najdete vysvětlení obou režimů.
předpona pronájmu	Není k dispozici	Předpona pro leasing, která se použije ve všech funkcích aplikace.

durableTask

Nastavení konfigurace pro Durable Functions

Poznámka:

Všechny hlavní verze Durable Functions jsou podporovány ve všech verzích modulu runtime Azure Functions. Schéma konfigurace host.json se ale mírně liší v závislosti na verzi modulu runtime Azure Functions a verzi rozšíření Durable Functions, kterou používáte.

Následující kód obsahuje dva příklady durableTask nastavení v host.json: jeden pro Durable Functions 2.x a jeden pro Durable Functions 1.x. Oba příklady můžete použít se službou Azure Functions 2.0 a 3.0. S Azure Functions 1.0 jsou dostupná nastavení stejná, ale část durableTask v souboru host.json se nachází v kořenovém adresáři konfigurace host.json místo toho, aby byla polem pod extensions.

Durable Functions 2.x
Durable Functions 1.x

{
 "extensions": {
  "durableTask": {
    "hubName": "MyTaskHub",
    "defaultVersion": "1.0",
    "versionMatchStrategy": "CurrentOrOlder",
    "versionFailureStrategy": "Reject",
    "storageProvider": {
      "connectionStringName": "AzureWebJobsStorage",
      "controlQueueBatchSize": 32,
      "controlQueueBufferThreshold": 256,
      "controlQueueVisibilityTimeout": "00:05:00",
      "FetchLargeMessagesAutomatically": true,
      "maxQueuePollingInterval": "00:00:30",
      "partitionCount": 4,
      "trackingStoreConnectionStringName": "TrackingStorage",
      "trackingStoreNamePrefix": "DurableTask",
      "useLegacyPartitionManagement": false,
      "useTablePartitionManagement": true,
      "workItemQueueVisibilityTimeout": "00:05:00",
      "QueueClientMessageEncoding": "UTF8"
    },
    "tracing": {
      "traceInputsAndOutputs": false,
      "traceReplayEvents": false,
    },
    "notifications": {
      "eventGrid": {
        "topicEndpoint": "https://topic_name.westus2-1.eventgrid.azure.net/api/events",
        "keySettingName": "EventGridKey",
        "publishRetryCount": 3,
        "publishRetryInterval": "00:00:30",
        "publishEventTypes": [
          "Started",
          "Completed",
          "Failed",
          "Terminated"
        ]
      }
    },
    "maxConcurrentActivityFunctions": 10,
    "maxConcurrentOrchestratorFunctions": 10,
    "maxConcurrentEntityFunctions": 10,
    "extendedSessionsEnabled": false,
    "extendedSessionIdleTimeoutInSeconds": 30,
    "useAppLease": true,
    "useGracefulShutdown": false,
    "maxEntityOperationBatchSize": 50,
    "maxOrchestrationActions": 100000,
    "storeInputsInOrchestrationHistory": false
  }
 }
}

{
  "extensions": {
    "durableTask": {
      "hubName": "MyTaskHub",
      "controlQueueBatchSize": 32,
      "partitionCount": 4,
      "controlQueueVisibilityTimeout": "00:05:00",
      "workItemQueueVisibilityTimeout": "00:05:00",
      "maxConcurrentActivityFunctions": 10,
      "maxConcurrentOrchestratorFunctions": 10,
      "maxQueuePollingInterval": "00:00:30",
      "azureStorageConnectionStringName": "AzureWebJobsStorage",
      "trackingStoreConnectionStringName": "TrackingStorage",
      "trackingStoreNamePrefix": "DurableTask",
      "traceInputsAndOutputs": false,
      "logReplayEvents": false,
      "eventGridTopicEndpoint": "https://topic_name.westus2-1.eventgrid.azure.net/api/events",
      "eventGridKeySettingName":  "EventGridKey",
      "eventGridPublishRetryCount": 3,
      "eventGridPublishRetryInterval": "00:00:30",
      "eventGridPublishEventTypes": ["Started", "Completed", "Failed", "Terminated"]
    }
  }
}

Majetek	Výchozí hodnota	Popis
název uzlu	TestHubName (DurableFunctionsHub v 1.x)	Název centra, ve které je uložen aktuální stav aplikace funkcí. Názvy centra úkolů musí začínat písmenem a obsahovat pouze písmena a číslice. Pokud nezadáte název, použije se výchozí hodnota. Názvy alternativních center úloh se dají použít k izolaci více aplikací Durable Functions od sebe, i když používají stejný back-end úložiště. Další informace najdete v tématu Centra úloh.
Verze defaultVersion		Výchozí verze, která se má přiřadit k novým instancím orchestrace. Při zadávání verze jsou nové instance orchestrace trvale přidruženy k této hodnotě verze. Toto nastavení používá funkce správy verzí orchestrace k povolení scénářů, jako jsou nasazení bez výpadků i při provádění zásadních změn. Pro verzi můžete použít libovolnou řetězcovou hodnotu.
strategiePorovnáníVerzí	Aktuální nebo starší	Hodnota, která určuje, jak se verze orchestrace slaďují při načítání funkcí orchestrátoru. Platné hodnoty jsou `None`, `Strict`a `CurrentOrOlder`. Podrobné vysvětlení najdete v tématu Verzování orchestrací.
strategie při selhání verze	Odmítat	Hodnota, která určuje, co se stane, když verze orchestrace neodpovídá aktuální `defaultVersion` hodnotě. Platné hodnoty jsou `Reject` a `Fail`. Podrobné vysvětlení najdete v tématu Verzování orchestrace.
controlQueueBatchSize	32	Počet zpráv, které se mají v jeden okamžik stáhnout z řídicí fronty
controlQueueBufferThreshold	Plán spotřeby pro Python: 32 Plán spotřeby pro další jazyky: 128 Vyhrazený plán nebo Plán Premium: 256	Počet zpráv řídicí fronty, které lze najednou uchovávat v paměťovém bufferu. Po dosažení zadaného čísla bude dispečer čekat před vyřazením dalších zpráv. V některých situacích může snížení této hodnoty významně snížit spotřebu paměti.
partitionCount	4	Počet oddílů pro řídicí frontu. Tato hodnota musí být kladné celé číslo od 1 do 16. Změna této hodnoty vyžaduje konfiguraci nového centra úloh.
řízení doby viditelnosti fronty	00:05:00	Časový limit viditelnosti zpráv odstrěněných z řídicí fronty ve formátu hh:mm:ss.
Časový limit viditelnosti fronty úkolů (workItemQueueVisibilityTimeout)	00:05:00	Časový limit viditelnosti zpráv ve frontě vyřazených pracovních položek ve formátu hh:mm:ss.
ZískatVelkéZprávyAutomaticky	pravda	Hodnota, která určuje, jestli se mají načítat velké zprávy v dotazech na stav orchestrace. Při tomto nastavení se `true`načtou velké zprávy, které překračují limit velikosti fronty. Při tomto nastavení se `false`načte adresa URL objektu blob, která odkazuje na každou velkou zprávu.
MaximálníPočetSoučasnýchFunkcíAktivit	Plán spotřeby: 10 Vyhrazený plán nebo plán Premium: 10krát počet procesorů na aktuálním počítači	Maximální počet funkcí aktivity, které mohou být současně zpracovány na jedné hostitelské instanci.
maximálníPočetSoučasnýchOrchestrátorovýchFunkcí	Plán spotřeby: 5 Vyhrazený plán nebo plán Premium: 10krát počet procesorů na aktuálním počítači	Maximální počet funkcí orchestrátoru, které lze současně zpracovat v jedné instanci hostitele.
Maximální počet současných funkcí entit (maxConcurrentEntityFunctions)	Plán spotřeby: 5 Vyhrazený plán nebo plán Premium: 10krát počet procesorů na aktuálním počítači	Maximální počet funkcí entity, které lze současně zpracovat v jedné instanci hostitele. Toto nastavení platí jenom v případě, že používáte trvalý plánovač úloh. V opačném případě je maximální počet souběžných spuštění entit omezen na `maxConcurrentOrchestratorFunctions` hodnotu.
maxQueuePollingInterval	00:00:30	Maximální řídicí interval a interval dotazování fronty pracovních položek ve formátu hh:mm:ss. Vyšší hodnoty můžou mít za následek vyšší latenci zpracování zpráv. Nižší hodnoty můžou mít za následek vyšší náklady na úložiště kvůli zvýšeným transakcím úložiště.
maxOrchestrationActions	100 000	Maximální počet akcí, které může funkce orchestrátoru provést během jednoho cyklu provádění.
connectionName (v2.7.0 a novější) connectionStringName (v2.x) azureStorageConnectionStringName (v1.x)	AzureWebJobsStorage	Název nastavení aplikace nebo kolekce nastavení, která určuje, jak se připojit k podkladovým prostředkům Azure Storage. Když zadáte jediné nastavení aplikace, mělo by se jednat o připojovací řetězec pro Azure Storage.
trackingStoreConnectionName (v2.7.0 a novější) trackingStoreConnectionStringName		Název nastavení aplikace nebo kolekce nastavení, která určuje, jak se připojit k tabulkám Historie a Instance, které ukládají historii provádění a metadata o instancích orchestrace. Když zadáte nastavení jediné aplikace, mělo by se jednat o připojovací řetězec Azure Storage. Pokud nezadáte nastavení, použije se hodnota připojení `connectionStringName` (v2.x) nebo hodnota připojení `azureStorageConnectionStringName` (v1.x).
trackingStoreNamePrefix		Předpona, která se má použít pro tabulky Historie a Instance, je-li `trackingStoreConnectionStringName` zadána. Pokud nezadáte předponu, použije se výchozí hodnota `DurableTask` . Pokud `trackingStoreConnectionStringName` není zadáno, tabulky Historie a Instance používají `hubName` hodnotu jako předponu a `trackingStoreNamePrefix` nastavení se ignoruje.
trasování vstupů a výstupů	nepravda	Hodnota, která určuje, zda se mají sledovat vstupy a výstupy volání funkce. Při trasování událostí spuštění funkce je výchozím chováním zahrnout počet bajtů do serializovaných vstupů a výstupů pro volání funkce. Toto chování poskytuje minimální informace o vstupech a výstupech, aby nedošlo k zahlcení protokolů a neúmyslnému zpřístupnění citlivých informací. Pokud je `true`tato vlastnost , celý obsah vstupů a výstupů funkce jsou protokolovány.
sledovatPřehranéUdálosti	nepravda	Hodnota, která označuje, zda se mají události přehrání orchestrací zapisovat do Application Insights.
logReplayEvents	nepravda	Hodnota, která označuje, zda se má protokolovat opakované spuštění v protokolech aplikace.
eventGridTopicEndpoint		URL adresa koncového bodu vlastního tématu služby Azure Event Grid. Při nastavování této vlastnosti se události oznámení o životním cyklu orchestrace publikují do tohoto koncového bodu. Tato vlastnost podporuje rozlišení nastavení aplikace.
NastaveníKlíčeEventGrid		Název nastavení aplikace, které obsahuje klíč použitý k ověřování pomocí vlastního tématu Event Gridu `EventGridTopicEndpoint` na adrese URL.
počítadloOpakováníPublikaceEventGrid	0	Počet opakování, pokud publikování do tématu Event Gridu selže.
eventGridPublishRetryInterval (interval opakování pro publikování událostí v Event Grid)	00:05:00	Interval opakování publikování v Event Grid ve formátu hh:mm:ss.
Typy událostí publikování v Event Grid (eventGridPublishEventTypes)		Seznam typů událostí, které se mají publikovat do Event Gridu. Pokud nezadáte žádné typy, publikují se všechny typy událostí. Povolené hodnoty zahrnují `Started`, `Completed`, `Failed`a `Terminated`.
povolenéRozšířenéSezení	nepravda	Hodnota, která určuje, zda jsou relace orchestrátoru a relace funkce entity ukládány do mezipaměti.
časový_limit_prodloužené_nečinnosti_relace_v_sekundách	30	Počet sekund, po které nečinný orchestrátor nebo funkce entity zůstanou v paměti před uvolněním. Toto nastavení se používá pouze, když je `extendedSessionsEnabled` nastaveno na `true`.
useAppLease	pravda	Hodnota indikující, zda aplikace musí před zpracováním zpráv centra úloh získat pronájem blobů na úrovni aplikace. Další informace naleznete v tématu Zotavení po havárii a geografické distribuce v Durable Functions. Toto nastavení je dostupné od verze 2.3.0.
useLegacyPartitionManagement	nepravda	Hodnota, která určuje typ algoritmu správy oddílů, který se má použít. Při tomto nastavení `false` se používá algoritmus, který snižuje možnost duplikování provádění funkcí při škálování. Toto nastavení je dostupné od verze 2.3.0. Nastavení této hodnoty na `true` nedoporučují.
useTablePartitionManagement	Ve verzi 3.x: pravda V 2.x: nepravda	Hodnota, která určuje typ algoritmu správy oddílů, který se má použít. Při tomto nastavení `true`se používá algoritmus, který je navržený ke snížení nákladů na účty Azure Storage v2. Toto nastavení je dostupné od WebJobs.Extensions.DurableTask v2.10.0. Použití tohoto nastavení se spravovanou identitou vyžaduje WebJobs.Extensions.DurableTask verze 3.x nebo novější nebo Worker.Extensions.DurableTask v1.2.x nebo novější.
PoužítUkončeníBezVýpadků	nepravda	(Preview) Hodnota, která označuje, jestli se má přívětivě vypnout, aby se snížila pravděpodobnost, že vypnutí hostitele může způsobit selhání provádění funkcí probíhajících v procesu.
maxEntityOperationBatchSize	Plán spotřeby: 50 Vyhrazený plán nebo Plán Premium: 5 000	Maximální počet operací entit, které se zpracovávají jako dávka. Pokud je tato hodnota 1, dávkování je zakázané a samostatné vyvolání funkce zpracuje každou zprávu o operaci. Toto nastavení je dostupné od verze 2.6.1.
ukládatVstupyDoOrchestrovéHistorie	nepravda	Hodnota, která určuje, jak ukládat vstupy. Pokud je toto nastavení nastaveno `true`, architektura Durable Task Framework ukládá vstupy aktivit v tabulce Historie a vstupy funkcí aktivit se zobrazí ve výsledcích dotazu historie orchestrace.
maxGrpcMessageSizeInBytes	4,194,304	Celočíselná hodnota, která nastavuje maximální velikost zpráv v bajtech, které může přijímat obecný klient vzdáleného volání procedur (gRPC). Implementace `DurableTaskClient` používá klienta gRPC ke správě instancí orchestrace. Toto nastavení platí pro izolovaný proces aplikací Durable Functions na platformě .NET a pro aplikace v Javě.
grpcHttpClientTimeout	00:01:40	Časový limit ve formátu hh:mm:ss pro klienta HTTP používaný klientem gRPC v Durable Functions. Klient je aktuálně podporovaný pro izolované pracovní aplikace .NET (.NET 6 a novější verze) a pro aplikace v Javě.
QueueClientMessageEncoding	UTF8	Strategie kódování pro zprávy azure Queue Storage. Platné strategie jsou formát transformace Unicode –8bitová (UTF8) a Base64. Toto nastavení platí, pokud používáte Microsoft.Azure.WebJobs.Extensions.DurableTask 3.4.0 nebo novější nebo Microsoft.Azure.Functions.Worker.Extensions.DurableTask 1.7.0 nebo novější.

Mnohé z těchto nastavení slouží k optimalizaci výkonu. Další informace najdete v tématu Výkon a škálování.

Středisko eventHub

Nastavení konfigurace pro triggery a vazby centra událostí

funkce

Seznam funkcí, které hostitel úlohy spouští. Prázdné pole znamená spuštění všech funkcí. Určeno k použití pouze při místním spuštění. V aplikacích funkcí v Azure byste měli místo toho postupovat podle kroků v části Jak zakázat funkce ve službě Azure Functions a zakázat konkrétní funkce místo použití tohoto nastavení.

{
    "functions": [ "QueueProcessor", "GitHubWebHook" ]
}

časový limit funkce

Určuje dobu časového limitu pro všechny funkce. V bezserverovém plánu Consumption je platný rozsah od 1 sekundy do 10 minut a výchozí hodnota je 5 minut. V plánu služby App Service neexistuje žádný celkový limit a výchozí hodnota je null, což značí žádný časový limit.

{
    "functionTimeout": "00:05:00"
}

monitor zdraví

Nastavení konfigurace pro monitorování stavu hostitele

{
    "healthMonitor": {
        "enabled": true,
        "healthCheckInterval": "00:00:10",
        "healthCheckWindow": "00:02:00",
        "healthCheckThreshold": 6,
        "counterThreshold": 0.80
    }
}

Majetek	Výchozí	Popis
povoleno	pravda	Určuje, jestli je funkce povolená.
healthCheckInterval	10 sekund	Časový interval mezi pravidelnými kontrolami stavu na pozadí.
okno kontroly zdraví	2 minuty	Posuvné časové okno použité s `healthCheckThreshold` nastavením.
práh kontroly zdraví	6	Maximální počet časů, kdy může selhat zdravotní kontrola, před zahájením recyklace hostitele.
prahová hodnota čítače	0.80	Prahová hodnota, při které bude čítač výkonu považován za nefunkční.

http

Nastavení konfigurace pro HTTP triggery a vazby.

{
    "http": {
        "routePrefix": "api",
        "maxOutstandingRequests": 200,
        "maxConcurrentRequests": 100,
        "dynamicThrottlesEnabled": true
    }
}

Majetek	Výchozí	Popis
Povolené dynamické omezení	nepravda	Pokud je toto nastavení povolené, způsobí to, že kanál zpracování požadavků pravidelně kontroluje čítače výkonu systému, jako jsou připojení, vlákna, procesy, paměť, procesor atd. a pokud některý z těchto čítačů překročí integrovanou vysokou prahovou hodnotu (80 %), požadavky se zamítnou s odpovědí 429 "Příliš zaneprázdněné", dokud se čítače nevrátí na normální úrovně.
MaximálníPočetSoučasnýchŽádostí	nevázané (`-1`)	Maximální počet funkcí HTTP, které se budou spouštět paralelně. Toto nastavení umožňuje řídit souběžnost, což vám může pomoct spravovat využití prostředků. Můžete mít například funkci HTTP, která používá velké množství systémových prostředků (paměť/procesor/sokety), které způsobují problémy, když je souběžnost příliš vysoká. Nebo můžete mít funkci, která provádí odchozí požadavky na službu třetí strany a tato volání musí být omezená rychlostí. V takových případech může pomoct implementace omezování.
maximální počet nevyřízených požadavků	nevázané (`-1`)	Maximální počet nevyřízených žádostí, které se v daném okamžiku uchovávají. Tento limit zahrnuje požadavky, které jsou ve frontě, ale ještě nezačaly být prováděny, a probíhající exekuce. Všechny příchozí požadavky nad tímto limitem jsou odmítnuty s odpovědí 429 "Příliš zaneprázdněné". To umožňuje volajícím využívat strategie opakování na základě času a také pomáhá řídit maximální latenci požadavků. To řídí pouze řazení, ke kterému dochází v rámci průběhu vykonávání hostitele skriptu. Ostatní fronty, jako je fronta požadavků ASP.NET, budou dál platit a toto nastavení na ně nebude mít vliv.
routePrefix	API	Předpona trasy, která se vztahuje na všechny trasy. Chcete-li odebrat výchozí předponu, použijte prázdný řetězec.

Identifikační číslo

Jedinečné ID pro hostitele úlohy. Může to být identifikátor GUID bez pomlček v malých písmenách. Vyžaduje se při místním spuštění. Při spuštění v Azure doporučujeme nenastavovat hodnotu ID. ID se v Azure vygeneruje automaticky, když id je vynechán.

Pokud sdílíte účet úložiště mezi více funkčními aplikacemi, ujistěte se, že každá funkční aplikace má jinou id. Vlastnost id můžete vynechat nebo ručně nastavit id každé funkční aplikace na jinou hodnotu. Trigger časovače používá zámek úložiště, aby se zajistilo, že při škálování funkční aplikace na více instancí bude existovat pouze jedna instance časovače. Pokud dvě aplikace funkcí sdílejí stejné id a každý používá trigger časovače, spustí se jenom jeden časovač.

{
    "id": "9f4ea53c5136457d883d685e57164f08"
}

protokolovací nástroj

Řídí filtrování protokolů psaných objektem ILogger nebo context.log.

{
    "logger": {
        "categoryFilter": {
            "defaultLevel": "Information",
            "categoryLevels": {
                "Host": "Error",
                "Function": "Error",
                "Host.Aggregator": "Information"
            }
        }
    }
}

Majetek	Výchozí	Popis
filtr kategorií	Není k dispozici	Určuje filtrování podle kategorie.
výchozí úroveň	Informace	Pro všechny kategorie, které nejsou zadané v `categoryLevels` poli, odešlete protokoly na této úrovni a výše do Application Insights.
úrovně kategorií	Není k dispozici	Pole kategorií, které určuje minimální úroveň protokolu, která se má odeslat do Application Insights pro každou kategorii. Kategorie zadaná zde řídí všechny kategorie, které začínají stejnou hodnotou, a delší hodnoty mají přednost. V předchozím ukázkovém souboru host.json všechny kategorie, které začínají s "Host.Aggregator", se zaznamenávají na úrovni `Information`. Všechny ostatní kategorie, které začínají na "Host", například "Host.Executor", zaznamenávají na `Error` úrovni.

fronty

Konfigurační nastavení pro triggery a vazby front úložiště.

{
    "queues": {
      "maxPollingInterval": 2000,
      "visibilityTimeout" : "00:00:30",
      "batchSize": 16,
      "maxDequeueCount": 5,
      "newBatchThreshold": 8
    }
}

Majetek	Výchozí	Popis
maxPollingInterval	60000	Maximální interval v milisekundách mezi dotazy fronty.
časový limit viditelnosti	0	Časový interval mezi opakovanými pokusy, když zpracování zprávy selže.
velikost dávky	16	Počet zpráv ve frontě, které modul runtime Služby Functions načítá a zpracovává paralelně. Když se zpracovávané číslo sníží na `newBatchThreshold`, modul runtime získá novou dávku a začne tyto zprávy zpracovávat. Takže maximální počet souběžných zpráv zpracovávaných na funkci je `batchSize` plus `newBatchThreshold`. Tento limit platí samostatně pro každou frontou aktivovanou funkci. Pokud se chcete vyhnout paralelnímu provádění zpráv přijatých v jedné frontě, můžete nastavit `batchSize` hodnotu 1. Toto nastavení ale eliminuje souběžnost jenom za předpokladu, že vaše aplikace funkcí běží na jednom virtuálním počítači. Pokud se funkční aplikace rozšíří na více virtuálních počítačů, může každý virtuální počítač spustit jednu instanci každé funkce aktivované frontou. Maximum `batchSize` je 32.
maxDequeueCount (maximální počet odebrání)	5	Počet pokusů o zpracování zprávy před přesunutím do fronty jedu
newBatchThreshold	batchSize/2	Pokaždé, když počet zpracovávaných zpráv současně přejde na toto číslo, modul runtime načte jinou dávku.

SendGrid

Nastavení konfigurace pro výstupní vazbu SendGrind

{
    "sendGrid": {
        "from": "Contoso Group <admin@contoso.com>"
    }
}

Majetek	Výchozí	Popis
od	Není k dispozici	E-mailová adresa odesílatele ve všech funkcích.

serviceBus

Nastavení konfigurace pro spouště a vazby služby Service Bus.

{ 
    "serviceBus": {
      "maxConcurrentCalls": 16,
      "prefetchCount": 100,
      "autoRenewTimeout": "00:05:00",
      "autoComplete": true
    }
}

Majetek	Výchozí	Popis
maximální počet současných hovorů	16	Maximální počet souběžných volání callbacku, které má zahájit pumpa zpráv. Modul runtime služby Functions ve výchozím nastavení zpracovává více zpráv současně. Chcete-li zaměřit runtime na zpracování pouze jedné fronty nebo jedné zprávy z tématu najednou, nastavte `maxConcurrentCalls` na 1.
počet přednačtení	Není k dispozici	Výchozí PrefetchCount, který bude použitý základním ServiceBusReceiver.
časový limit automatického obnovení	00:05:00	Maximální doba trvání, během které se zámek zprávy obnoví automaticky.
automatické dokončování	pravda	Pokud je hodnota true, trigger dokončí zpracování zpráv automaticky při úspěšném spuštění operace. Pokud je nepravda, je odpovědností funkce dokončit zprávu před vrácením.

jednoznačný

Nastavení chování zámku Singleton. Další informace najdete v tématu o problému GitHubu s podporou singletonu.

{
    "singleton": {
      "lockPeriod": "00:00:15",
      "listenerLockPeriod": "00:01:00",
      "listenerLockRecoveryPollingInterval": "00:01:00",
      "lockAcquisitionTimeout": "00:01:00",
      "lockAcquisitionPollingInterval": "00:00:03"
    }
}

Majetek	Výchozí	Popis
doba uzamčení	00:00:15	Období, během kterého se používají zámky na úrovni funkce. Zámky se automaticky obnovují.
listener-lock-period	00:01:00	Doba, po kterou jsou použity zámky posluchače.
ListenerLockRecoveryPollingInterval	00:01:00	Časový interval použitý pro obnovení zámku naslouchání, pokud se nepodařilo získat zámek při spuštění naslouchacího procesu.
časový limit pro získání zámku	00:01:00	Maximální doba, po kterou se modul runtime pokusí získat zámek.
interval pro dotazování na získání zámku	Není k dispozici	Interval mezi pokusy o získání zámku.

trasování

Verze 1.x

Konfigurační nastavení pro protokoly, které vytvoříte pomocí objektu TraceWriter. Další informace najdete v tématu [Protokolování jazyka C#].

{
    "tracing": {
      "consoleLevel": "verbose",
      "fileLoggingMode": "debugOnly"
    }
}

Majetek	Výchozí	Popis
úroveň konzole	informace	Úroveň trasování pro konzolové protokolování. Možnosti jsou: `off`, `error`, `warning`, `info`a `verbose`.
mód zápisu do souboru	DebugOnly	Úroveň trasování pro záznam souborů. Možnosti jsou `never`, `always`, `debugOnly`.

sledovat adresáře

Sada sdílených adresářů kódu, které by měly být monitorovány pro změny. Zajišťuje, že když se změní kód v těchto adresářích, budou změny zohledněny vašimi funkcemi.

{
    "watchDirectories": [ "Shared" ]
}

Další kroky

Informace o aktualizaci souboru host.json

Zachování nastavení v proměnných prostředí

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-11-08