host.json hivatkozás az Azure Functions 1.x-hez

A host.json metaadatfájl olyan konfigurációs beállításokat tartalmaz, amelyek hatással vannak egy függvényalkalmazás példányának összes függvényére. Ez a cikk felsorolja a beállításokat, amelyek elérhetőek az 1.x verziójú futtatókörnyezet számára. A JSON-séma a következő helyen http://json.schemastore.org/hosttalálható: .

Megjegyzés

Ez a cikk az Azure Functions 1.x számára készült. Az Azure Functions 2.x vagy későbbi verziókhoz tartozó host.json-ra vonatkozó útmutatásért lásd a host.json referenciát az Azure Functions 2.x esetén.

A többi funkcióalkalmazás-konfigurációs lehetőséget az alkalmazásbeállításaiban kezelheti.

Bizonyos host.json beállítások csak akkor kerülnek felhasználásra, amikor helyben futtatják őket a local.settings.json fájlban.

Minta host.json fájl

A következő host.json fájl minták minden lehetséges beállítást tartalmaznak.

{
    "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" ],
}

A cikk következő szakaszai magyarázzák el az egyes felső szintű tulajdonságokat. Mindegyik opcionális, hacsak másként nincs jelezve.

aggregátor

Adja meg, hány függvényhívás van összesítve, amikor az Alkalmazás Insights számára méri a metrikákat.

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

Tulajdon	Alapértelmezett	Leírás
kötegméret	1000	Maximális számú kérés összevonásra.
flushTimeout	00:00:30	Maximális halmozási időszak.

A függvényhívások összesítése megtörténik, amikor a két határ közül az első elérve van.

Alkalmazás-elemzések

Az Application Insights mintavételi funkciójának vezérlése.

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

Tulajdon	Alapértelmezett	Leírás
engedélyezett	igaz	Lehetővé teszi vagy letiltja a mintavételezést.
maxTelemetriaElemekMásodpercenként	5	Az a küszöb, ahol a mintavétel megkezdődik.

DocumentDB

Az Azure Cosmos DB trigger és kötés konfigurációs beállításai.

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

Tulajdon	Alapértelmezett	Leírás
Átjáró Mód	Átjáró	A kapcsolódási mód, amelyet a funkció használ az Azure Cosmos DB szolgáltatáshoz való csatlakozáskor. Opciók: `Direct` és `Gateway`
Protokoll	Https	A funkció által használt kapcsolati protokoll az Azure Cosmos DB szolgáltatáshoz való kapcsolódáskor. Olvassa el itt mindkét üzemmód magyarázatát
bérleti előtag	nincs adat	** Az alkalmazás összes funkciójában használandó bérleti előtag.

tartósFeladat

Konfigurációs beállítások a Durable Functions-hoz.

Megjegyzés

Az összes főbb verziója a Durable Functions-nek támogatott az Azure Functions futtatókörnyezet összes verzióján. A host.json konfiguráció sémája azonban kissé eltér az Azure Functions-futtatókörnyezet verziójától és a használt Durable Functions-bővítmény verziójától függően.

Az alábbi kód két példát mutat be a durableTaskhost.jsonbeállításaira: egyet a Durable Functions 2.x-hez, egyet pedig a Durable Functions 1.x-hez. Mindkét példát használhatja az Azure Functions 2.0 és a 3.0 használatával. Az Azure Functions 1.0-val a rendelkezésre álló beállítások megegyeznek, de a durableTaskhost.json szakasza a host.json konfiguráció gyökerében található ahelyett, hogy a mező extensionsalatt található.

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"]
    }
  }
}

Tulajdon	Alapértelmezett érték	Leírás
hubNév	TestHubName (DurableFunctionsHub in v1.x)	A függvényalkalmazás aktuális állapotát tároló központ neve. A 'Task hub' neveknek betűvel kell kezdődniük, és csak betűket és számokat tartalmazhatnak. Ha nem ad meg nevet, a rendszer az alapértelmezett értéket használja. A másodlagos feladatközpontok nevei több Durable Functions-alkalmazás egymástól való elkülönítésére is használhatók, még akkor is, ha ugyanazt a háttértárat használják. További információért lásd a következőt: Feladatközpontok.
defaultVersion		Az új vezénylési példányokhoz rendelendő alapértelmezett verzió. Verzió megadásakor az új vezénylési példányok véglegesen hozzá lesznek rendelve ehhez a verzióértékhez. Ezt a beállítást az orkesztrációs verziózás funkció használja olyan forgatókönyvek engedélyezésére, mint a megszakítás nélküli telepítések kompatibilitást megtörő változtatásokkal. A verzióhoz bármilyen sztringértéket használhat.
verzióillesztési stratégia	Aktuális vagy régebbi	A vezénylési verziók illesztését meghatározó érték a vezénylési funkciók betöltésekor. Az érvényes értékek a következők: `None`, `Strict`és `CurrentOrOlder`. Részletes magyarázatért lásd az Orchestration verziózását.
verzióhiba-kezelési stratégia	Elutasít	Olyan érték, amely meghatározza, hogy mi történik, ha egy vezénylési verzió nem egyezik meg az aktuális `defaultVersion` értékkel. Az érvényes értékek a következők: `Reject` és `Fail`. Részletes magyarázatért lásd az Orchestration verziózását.
controlQueueBatchSize	32	Az üzenetek száma, amelyeket egy időben ki kell húzni a vezérlési sorból.
vezérlősor-pufferküszöb	Fogyasztási terv Pythonhoz: 32 Használati terv más nyelvekhez: 128 Dedikált vagy Prémium csomag: 256	A memóriában egyszerre pufferelhető vezérlősor-üzenetek száma. A megadott szám elérésekor a kézbesítő megvárja, mielőtt bármilyen más üzenetet töröl. Bizonyos esetekben ennek az értéknek a csökkentése jelentősen csökkentheti a memóriahasználatot.
partíciók száma	4	A vezérlési várólista partíciószáma. Ennek az értéknek 1 és 16 közötti pozitív egész számnak kell lennie. Az érték módosításához új feladatközpontot kell konfigurálni.
vezérlésiSorLáthatóságiIdőtúllépés	00:05:00	A lekérdezett vezérlő üzenetsor-üzeneteinek láthatósági időtúllépése hh:mm:ss formátumban.
workItemQueueLáthatóságiIdőkorlát	00:05:00	A lekérdezett munkaelem-üzenetsor üzeneteinek láthatósági időtúllépése hh:mm:ss formátumban.
Nagy üzenetek automatikus letöltése	igaz	Egy érték, amely meghatározza, hogy nagy méretű üzeneteket szeretne-e lekérni a vezénylési állapot-lekérdezésekben. Ha ez a beállítás, `true`a rendszer az üzenetsor méretkorlátját meghaladó nagyméretű üzeneteket kér le. Ha ez a beállítás `false`, akkor a rendszer lekéri az egyes nagy üzenetekre mutató blob URL-címeket.
maximális egyidejű aktivitási funkciók	Fogyasztási terv: 10 Dedikált vagy Prémium csomag: az aktuális gépen lévő processzorok számának tízszerese	Egyetlen hosztpéldányon párhuzamosan feldolgozható aktivitási funkciók maximális száma.
maximális párhuzamos orchestrátor funkciók	Fogyasztási terv: 5 Dedikált vagy Prémium csomag: az aktuális gépen lévő processzorok számának tízszerese	Az egyetlen gazdagép példányon egyidejűleg feldolgozható orkesztrátorfunkciók maximális száma.
Maximális egyidejű entitásfunkciók	Fogyasztási terv: 5 Dedikált vagy Prémium csomag: az aktuális gépen lévő processzorok számának tízszerese	Az egy gazdagéppéldányon egyidejűleg feldolgozható entitásfüggvények maximális száma. Ez a beállítás csak akkor alkalmazható, ha a tartós feladatütemezőt használja. Ellenkező esetben az egyidejű entitásvégrehajtások maximális száma az `maxConcurrentOrchestratorFunctions` értékre korlátozódik.
maxQueuePollingInterval (maximális sorfigyelési időköz)	00:00:30	A vezérlő és a munkaelem-üzenetsor lekérdezési időközének maximális értéke hh:mm:ss formátumban. Magasabb értékek magasabb üzenetfeldolgozási késedelmeket eredményezhetnek. Az alacsonyabb értékek magasabb tárolási költségeket eredményezhetnek a megnövekedett tárhelytranzakciók miatt.
maxOrchestrationActions	100,000	A vezénylő függvények által végrehajtható műveletek maximális száma egyetlen végrehajtási ciklus során.
connectionName (2.7.0-s és újabb verziók) connectionStringName (v2.x) azureStorageConnectionStringName (v1.x)	AzureWebJobsStorage	Egy alkalmazásbeállítás vagy beállításgyűjtemény neve, amely meghatározza, hogyan kell csatlakozni a mögöttes Azure Storage erőforrásokhoz. Ha egyetlen alkalmazásbeállítást ad meg, annak egy Azure Storage kapcsolati sztringnek kell lennie.
trackingStoreConnectionName (2.7.0-s és újabb verzió) trackingStoreConnectionStringName		Egy alkalmazásbeállítás vagy beállításgyűjtemény neve, amely meghatározza, hogyan csatlakozhat az Előzmények és példányok táblákhoz, amelyek a végrehajtási előzményeket és a vezénylési példányok metaadatait tárolják. Ha egyetlen alkalmazásbeállítást ad meg, annak egy Azure Storage kapcsolati sztringnek kell lennie. Ha nem ad meg beállítást, a `connectionStringName` érték (v2.x) vagy a `azureStorageConnectionStringName` érték (v1.x) kapcsolat lesz használva.
nyomkövetőBoltNévElőtag		Az előtag, amelyet a História és Példányok táblázatokhoz kell használni, amikor a `trackingStoreConnectionStringName` meg van adva. Ha nem ad meg előtagot, a rendszer az alapértelmezett értéket `DurableTask` használja. Ha `trackingStoreConnectionStringName` nincs megadva, az Előzmények és példányok tábla az `hubName` értéket használja előtagként, és a `trackingStoreNamePrefix` beállítás figyelmen kívül lesz hagyva.
bemenetekÉsKimenetekNyomonKövetése	hamis	Egy érték, amely jelzi, hogy nyomon kell-e követni a függvényhívások bemeneteit és kimeneteit. A függvényvégrehajtási események nyomon követése esetén az alapértelmezett viselkedés, hogy a szerializált bemenetek és kimenetek, valamint a függvényhívások esetén a bájtok számának feltüntetése megtörténik. Ez a viselkedés minimális információt nyújt a bemenetekről és a kimenetekről, így nem blobálja a naplókat, és nem teszi elérhetővé a bizalmas információkat. Ha ez a tulajdonság, `true`a függvénybemenetek és -kimenetek teljes tartalmát naplózza a rendszer.
események visszajátszásának nyomkövetése	hamis	Egy érték, amely jelzi, hogy a vezénylési visszajátszási eseményeket az Application Insightsba kell-e írni.
napló-visszajátszás események	hamis	Egy érték, amely jelzi, hogy az újrajátszott végrehajtásokat naplózza-e az alkalmazásnaplókban.
eseményhálózatiTémaVégpont		Egy Azure Event Grid egyéni témakör végpontjának URL-je. A tulajdonság beállításakor a vezénylési életciklus értesítési eseményei közzé lesznek téve ezen a végponton. Ez a tulajdonság támogatja az alkalmazásbeállítások feloldását.
eseményhálózatKiegészítőKulcsBeállításNév		Annak az alkalmazásbeállításnak a neve, amely az Event Grid egyéni témakörével való hitelesítéshez használt kulcsot tartalmazza az `EventGridTopicEndpoint` URL-címen.
eseményrács-közzétételÚjrapróbálkozásSzámláló	0	Az újrapróbálkozások száma, ha sikertelen a közzététel az Event Grid-témakörben.
eseményRácsKözzétételiÚjrapróbálkozásiIdőköz	00:05:00	Az Event Grid közzétételi-újrapróbálkozási időköz hh:mm:ss formátumban.
EventGridPublikálásiEseménytípusok		Az eseménytípusok listája, amelyeket közzé kell tenni az Event Grid számára. Ha nem ad meg semmilyen típust, az összes eseménytípus közzé lesz téve. Az engedélyezett értékek a következők: `Started`, `Completed`, `Failed`és `Terminated`.
bővítettMunkamenetekEngedélyezve	hamis	Egy érték, amely meghatározza, hogy a munkamenetvezénylő és az entitásfüggvény munkamenetek gyorsítótárba kerülnek-e.
kiterjesztettMunkamenetTétlenIdőtúllépésMásodpercben	30	Az inaktív vezénylő vagy entitásfüggvények hány másodpercig maradnak a memóriában a kiürítés előtt. Ezt a beállítást csak akkor használják, ha a `extendedSessionsEnabled` beállítás `true`.
useAppLease	igaz	Egy érték, amely azt jelzi, hogy az alkalmazásoknak alkalmazásszintű blobbérletet kell-e beszerezniük a feladatközpont-üzenetek feldolgozása előtt. További információ: Vészhelyreállítás és geoeloszlás a Durable Functionsben. Ez a beállítás a 2.3.0-s verziótól érhető el.
használja a régi partíciókezelést	hamis	A használandó partíciókezelési algoritmus típusát meghatározó érték. Ebben a `false`beállításban olyan algoritmust használunk, amely csökkenti a függvények duplikálásának lehetőségét a horizontális felskálázáskor. Ez a beállítás a 2.3.0-s verziótól érhető el. Az érték `true` beállítása nem ajánlott.
táblapartíciókezelés használata	V3.x esetén: igaz V2.x esetén: hamis	A használandó partíciókezelési algoritmus típusát meghatározó érték. Ebben a beállításban `true`egy algoritmust használunk, amely az Azure Storage v2-fiókok költségeinek csökkentésére szolgál. Ez a beállítás a WebJobs.Extensions.DurableTask 2.10.0-s verziótól kezdve érhető el. Ha ezt a beállítást felügyelt identitással használja, a WebJobs.Extensions.DurableTask v3.x vagy újabb, illetve a Worker.Extensions.DurableTask v1.2.x vagy újabb verzióra van szükség.
használja a Kifinomult Leállítási Módot	hamis	(Előzetes verzió) Olyan érték, amely azt jelzi, hogy a gazdaleállások kecses leállítása csökkenti-e a folyamaton belüli függvényvégrehajtások meghiúsulásának esélyét.
maxEntityOperationBatchMéret	Fogyasztási terv: 50 Dedikált vagy Prémium csomag: 5000	Az entitás műveletek maximális száma, amelyeket batch-ként dolgoznak fel. Ha ez az érték 1, a kötegelés le van tiltva, és egy külön függvényhívás dolgozza fel az egyes műveleti üzeneteket. Ez a beállítás a 2.6.1-től érhető el.
bemenetek tárolása az orchestration történetében	hamis	A bemenetek tárolásának módját meghatározó érték. Ha ez a beállítás `true`, a Durable Task Framework elmenti a tevékenységbemeneteket az Előzmények táblában, és a tevékenységfüggvények bemenetei megjelennek a vezénylési előzmények lekérdezésének eredményeiben.
maxGrpc üzenetméret bájtokban	4,194,304	Egy egész számérték, amely meghatározza az általános távoli eljáráshívási (gRPC) ügyfél által fogadható üzenetek maximális méretét bájtban. A implementáció `DurableTaskClient` a gRPC-ügyfél használatával kezeli a vezénylési példányokat. Ez a beállítás a Durable Functions .NET izolált feldolgozói és Java-alkalmazásokra vonatkozik.
grpcHttpClientTimeout	00:01:40	Az időtúllépés hh:mm:ss formátumban a gRPC-ügyfél által a Durable Functionsben használt HTTP-ügyfélhez. Az ügyfél jelenleg a .NET izolált feldolgozói alkalmazásokhoz (.NET 6-os és újabb verziókhoz) és Java-alkalmazásokhoz támogatott.
QueueClientMessageEncoding	UTF8	Az Azure Queue Storage-üzenetek kódolási stratégiája. Az érvényes stratégiák a Unicode Transformation Format–8 bites (UTF8) és a Base64. Ez a beállítás a Microsoft.Azure.WebJobs.Extensions.DurableTask 3.4.0-s vagy újabb, illetve a Microsoft.Azure.Functions.Worker.Extensions.DurableTask 1.7.0-s vagy újabb verziójára vonatkozik.

Ezeknek a beállításoknak a többsége a teljesítmény optimalizálására szolgál. További információért tekintse meg a Performance and scale részt.

eventHub

Az Event Hub aktiválók és kötései konfigurációs beállításai.

funkciók

A feladatgazda által futtatott funkciók listája. Az üres tömb azt jelenti, hogy minden függvényt futtatni kell. Csak helyi futtatás esetén használható. Az Azure-ban található funkcióalkalmazások esetében kövesse az Funkciók letiltása az Azure Functions-ben útmutató lépéseit a specifikus funkciók letiltásához, ahelyett, hogy ezt a beállítást használná.

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

functionTimeout

Jelzi az időtúllépés időtartamát minden funkció esetében. Egy szerver nélküli Fogyasztási tervben az érvényes intervallum 1 másodperctől 10 percig terjed, és az alapértelmezett érték 5 perc. Egy App Service tervben nincs átfogó korlát, és az alapértelmezett érték null, ami azt jelenti, hogy nincs időkorlát.

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

egészségfigyelő

Konfigurációs beállítások a Host health monitor-hoz.

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

Tulajdon	Alapértelmezett	Leírás
engedélyezett	igaz	Megadja, hogy a funkció engedélyezve van-e.
egészségügyi ellenőrzés időköze	10 másodperc	Az időintervallum az időszakos háttér-egészségügyi ellenőrzések között.
egészségügyiEllenőrzésAblak	2 perc	Egy csúszóidőablak, amelyet a `healthCheckThreshold` beállítással használnak.
egészségügyi ellenőrzési küszöb	6	A maximum egészségügyi ellenőrzés sikertelenségeinek száma, mielőtt a hoszt újraindítása megkezdődik.
számláló küszöbérték	0.80	Az a küszöbérték, amelynél egy teljesítményszámláló egészségtelennek minősül.

http

Konfigurációs beállítások a http triggerekhez és kötve.

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

Tulajdon	Alapértelmezett	Leírás
dinamikus fojtások engedélyezve	hamis	Amikor engedélyezve van, ez a beállítás azt okozza, hogy a kérésfeldolgozó csatorna időszakonként ellenőrzi a rendszer teljesítménymutatóit, például a kapcsolatok, szálak, folyamatok, memória, CPU stb., és ha bármelyik mutató meghaladja a beépített magas küszöbértéket (80%), a kérések elutasításra kerülnek egy 429 "Túlterhelt" válasszal, amíg a mutató(k) vissza nem térnek a normál szintre.
maximális egyidejű kérések	korlátlan (`-1`)	A maximálisan párhuzamosan végrehajtható HTTP-funkciók száma. Ez lehetővé teszi a párhuzamosítás szabályozását, ami segíthet az erőforrások felhasználásának kezelésében. Például lehet egy HTTP-függvényed, amely sok rendszererőforrást (memória/CPU/socket) használ, ami problémákat okoz, ha a párhuzamosság túl magas. Lehet, hogy van egy függvény, amely kimenő kéréseket küld egy harmadik fél szolgáltatására, és ezeket a hívásokat korlátozni kell. Ilyen esetekben a fojtószelep alkalmazása itt segíthet.
maximálisKimenőKérések	korlátlan (`-1`)	Az egy időben visszatartott kérések maximális száma. Ez a korlát magában foglalja a várakozó kéréseket, amelyek még nem kezdtek végrehajtódni, valamint bármely folyamatban lévő végrehajtást. Az ezen a korláton túli beérkező kéréseket egy 429-es "Túlterhelt" válasz elutasítja. Ez lehetővé teszi a hívók számára, hogy időalapú újrapróbálkozási stratégiákat alkalmazzanak, és segít Önnek a maximális kéréskésések szabályozásában. Ez csak a várólistázást irányítja, amely a szkriptgazda végrehajtási útvonalán belül történik. Más sorok, mint például az ASP.NET kérés sor, továbbra is érvényben lesznek, és ez a beállítás nem érinti őket.
útvonalelőtag	API	Az útvonal előtag, amely minden útvonalra érvényes. Használjon üres karakterláncot az alapértelmezett előtag eltávolításához.

azonosító

Az egyedi azonosító egy feladatgazdához. Lehet egy kisbetűs GUID kötőjelek nélkül. Szükséges, amikor helyben futtatják. Amikor az Azure-ban futtat, javasoljuk, hogy ne állítson be ID értéket. Az Azure automatikusan generál egy azonosítót, amikor a id ki van hagyva.

Ha egy tárfiókot több funkciós alkalmazás között oszt meg, győződjön meg róla, hogy minden funkciós alkalmazásnak különböző id van. Elhagyhatja a id tulajdonságot, vagy minden funkcióalkalmazás id értékét manuálisan más-más értékre állíthatja. Az időzítő kiváltó egy tárolózárat használ annak biztosítására, hogy csak egy időzítő példány létezzen, amikor egy funkcióalkalmazás több példányra méreteződik. Ha két funkcióalkalmazás ugyanazt a id birtokolja, és mindegyik időzítő triggert használ, csak egy időzítő fut.

{
    "id": "9f4ea53c5136457d883d685e57164f08"
}

naplózó

Szabályozza a ILogger objektum vagy a context.log által írt naplók szűrését.

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

Tulajdon	Alapértelmezett	Leírás
kategóriaszűrő	nincs adat	Megadja a kategória szerinti szűrést
alapértelmezett szint	Információ	Azoknál a kategóriáknál, amelyeket nem adtunk meg a `categoryLevels` tömbben, küldje el a naplókat ezen a szinten és fölötte az Application Insights-hoz.
kategóriaszintek	nincs adat	Kategóriák tömbje, amely meghatározza a minimális naplózási szintet, amelyet az Application Insights számára küldeni kell minden egyes kategóriához. Az itt megadott kategória irányít minden olyan kategóriát, amely ugyanazzal az értékkel kezdődik, és a hosszabb értékek élveznek elsőbbséget. Az előző mintában található host.json fájl minden, "Host.Aggregator" kezdetű kategóriája `Information` szinten naplóz. Az összes többi kategória, amely "Host"-tal kezdődik, mint például "Host.Executor", `Error` szinten naplózódik.

sorok

Konfigurációs beállítások a tároló sor trigger-ekhez és kötés-ekhez.

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

Tulajdon	Alapértelmezett	Leírás
maximális lekérdezési intervallum	60000	A sorvárások közötti maximális időköz milliszekundumban.
láthatósági időkorlát	0	A sikertelen üzenetfeldolgozás esetén az újrapróbálkozások közötti időköz.
kötegméret	16	Azoknak a várólistás üzeneteknek a száma, amelyeket a Functions futtatókörnyezet egyszerre lehív és párhuzamosan feldolgoz. Amikor a feldolgozott adatok száma lecsökken a `newBatchThreshold` szintre, a futási idő újabb adagot kap, és elkezdi feldolgozni ezeket az üzeneteket. Az egyes függvények által egyidejűleg feldolgozott üzenetek maximális száma `batchSize` plusz `newBatchThreshold`. Ez a korlát külön-külön érvényes minden sorban beindított funkcióra. Ha el akarja kerülni a párhuzamos végrehajtást az egy soron kapott üzenetek esetén, akkor állítsa `batchSize` értékét 1-re. Azonban ez a beállítás csak addig szünteti meg a párhuzamosságot, amíg a funkciós alkalmazása egyetlen virtuális gépen (VM) fut. Ha a funkcióalkalmazás több virtuális gépre skálázódik, akkor minden virtuális gép futtathat egy példányt az egyes sorvezérelt funkciókból. A maximum `batchSize` értéke 32.
maximális sorbavételi szám	5	Az üzenet feldolgozásának próbálkozásainak száma, mielőtt a mérgező sorba helyeznék.
newBatchThreshold	batchSize/2	Amikor a párhuzamosan feldolgozott üzenetek száma erre a számra csökken, a futtatási idő újabb csomagot kér le.

SendGrid

Konfigurációs beállítás a SendGrind kimeneti kötéséhez

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

Tulajdon	Alapértelmezett	Leírás
tól/től	nincs adat	A feladó e-mail címe minden funkcióban.

serviceBus

A Service Bus triggers és kötéseinek konfigurációs beállítása.

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

Tulajdon	Alapértelmezett	Leírás
maximális egyidejű hívások száma	16	A visszahívás egyidejű hívásainak maximális száma, amelyet az üzenetszivattyúnak kezdeményeznie kell. Alapértelmezés szerint a Functions futásideje több üzenetet dolgoz fel párhuzamosan. Az idő futtatása érdekében, hogy egyszerre csak egyetlen sorban álló vagy témához tartozó üzenetet dolgozzon fel, állítsa a `maxConcurrentCalls` értéket 1-re.
prefetchCount	nincs adat	Az alapértelmezett PrefetchCount, amelyet az alatta lévő ServiceBusReceiver fog használni.
autoRenewTimeout	00:05:00	A maximális időtartam, amelyen belül az üzenet zárolása automatikusan megújul.
automatikus kitöltés	igaz	Amikor igaz, a trigger automatikusan befejezi az üzenet feldolgozását a művelet sikeres végrehajtásakor. Amikor hamis, a függvény felelőssége, hogy befejezze az üzenetet, mielőtt visszatér.

egyedülálló

A Singleton zárolási viselkedés konfigurációs beállításai. További információkért lásd a GitHub probléma a szingleton támogatásáról.

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

Tulajdon	Alapértelmezett	Leírás
zárlati időszak	00:00:15	Az időszak, amikor a funkciószintű zárolások életbe lépnek. A zárak automatikusan megújulnak.
hallgatói zárolási időszak	00:01:00	Az az időszak, amelyre a hallgatói zárakat rögzítik.
zárolásfigyelő helyreállítási lekérdezési intervallum	00:01:00	Az az időintervallum, amelyet a hallgató zár visszaállítására használnak, ha a hallgató zárat nem lehetett megszerezni az indításkor.
lockAcquisitionTimeout	00:01:00	A maximális idő, ameddig a futási idő megpróbál zárat szerezni.
lockŕszerzés_kérdezési_időköz	nincs adat	A zárolás megszerzési próbálkozásai közötti intervallum.

nyomon követés

1.x-es verzió

Konfigurációs beállítások a naplókhoz, amelyeket TraceWriter objektum segítségével hoz létre. Ha többet szeretne megtudni, lásd: [C# Logging].

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

Tulajdon	Alapértelmezett	Leírás
konzolszint	információ	A konzol naplózás követési szintje. Opciók: `off`, `error`, `warning`, `info`, és `verbose`.
fájl naplózási mód	debugOnly	A fájl naplózásának követési szintje. A lehetségek a következők: `never`, `always`, `debugOnly`.

watchDirectories

Egy sor megosztott kódkönyvtár, amelyeket figyelni kell a változások miatt. Biztosítja, hogy amikor a kódot ezekben a könyvtárakban megváltoztatják, a változtatásokat a funkciói észleljék.

{
    "watchDirectories": [ "Shared" ]
}

Következő lépések

Tudja meg, hogyan frissítheti a host.json fájlt

Konfigurációs beállítások mentése környezeti változókba

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2025-11-08