host.json-verwijzing voor Azure Functions 1.x

Het host.json metagegevensbestand bevat configuratieopties die van invloed zijn op alle functies in een exemplaar van een functie-app. Dit artikel bevat de instellingen die beschikbaar zijn voor de runtime van versie 1.x. Het JSON-schema bevindt zich op http://json.schemastore.org/host.

Andere configuratieopties voor functie-apps worden beheerd in uw app-instellingen.

Sommige host.json-instellingen worden alleen gebruikt wanneer ze lokaal worden uitgevoerd in het local.settings.json-bestand .

Voorbeeldbestand host.json

In het volgende voorbeeld host.json bestanden zijn alle mogelijke opties opgegeven.

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

In de volgende secties van dit artikel wordt elke eigenschap op het hoogste niveau uitgelegd. Alle zijn optioneel, tenzij anders aangegeven.

samenvoeger

Hiermee geeft u op hoeveel functieaanroepen worden geaggregeerd wanneer u meetwaarden voor Application Insights berekent.

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

Functie-aanroepen worden geaggregeerd wanneer de eerste van de twee limieten is bereikt.

applicationInsights

Hiermee beheert u de steekproeffunctie in Application Insights.

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

DocumentDB

Configuratie-instellingen voor de Azure Cosmos DB-trigger en -koppelingen.

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

duurzame taak

Configuratie-instellingen voor Durable Functions.

In Azure Functions runtime 1.x bevindt de durableTask sectie zich aan de wortel van het host.json bestand. De beschikbare instellingen hangen af van de versie van de Durable Functions-extensie. Voor de huidige configuratiereferentie, zie Durable Functions host.json instellingen.

eventHub

Configuratie-instellingen voor Event Hub-triggers en -bindingen.

functies

Een lijst met functies die door de taakhost worden uitgevoerd. Een lege matrix betekent dat alle functies worden uitgevoerd. Alleen bedoeld voor gebruik wanneer lokaal uitgevoerd. In functie-apps in Azure moet u in plaats daarvan de stappen in Hoe functies uitschakelen in Azure Functions volgen om specifieke functies uit te schakelen in plaats van deze instelling te gebruiken.

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

functionTimeout

Geeft de time-outduur voor alle functies aan. In een serverloos verbruiksabonnement is het geldige bereik van 1 seconde tot 10 minuten en de standaardwaarde is 5 minuten. In een App Service-plan is er geen algemene limiet en is de standaardwaarde null, wat aangeeft dat er geen time-out is.

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

gezondheidsmonitor

Configuratie-instellingen voor Host-statusmonitor.

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

http

Configuratie-instellingen voor HTTP-triggers en bindings.

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

identiteitskaart

De unieke ID voor een taakbeheerder. Kan een GUID in kleine letters met verwijderde streepjes zijn. Vereist bij lokale uitvoering. Als u in Azure werkt, raden we aan geen ID-waarde in te stellen. Er wordt automatisch een id gegenereerd in Azure wanneer id wordt weggelaten.

Als u een opslagaccount deelt in meerdere functie-apps, moet u ervoor zorgen dat elke functie-app een andere idheeft. U kunt de id eigenschap weglaten of elke functie-app id handmatig instellen op een andere waarde. De timertrigger maakt gebruik van een opslagvergrendeling om ervoor te zorgen dat er slechts één timerexemplaar is wanneer een functie-app wordt uitgebreid tot meerdere exemplaren. Als twee functie-apps hetzelfde id delen en elk een timertrigger gebruikt, wordt slechts één timer uitgevoerd.

{
    "id": "9f4ea53c5136457d883d685e57164f08"
}

logboek

Hiermee bepaalt u het filteren van logboeken die zijn geschreven door een ILogger-object of door context.log.

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

wachtrijen

Configuratie-instellingen voor opslagwachtrijtriggers en -bindingen.

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

SendGrid

Configuratie-instelling voor de SendGrid outputbinding.

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

serviceBus

Configuratie-instelling voor Service Bus triggers en bindingen.

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

singleton

Configuratie-instellingen voor Singleton-vergrendelingsgedrag. Zie GitHub probleem met singleton-ondersteuning voor meer informatie.

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

traceren

Versie 1.x

Configuratie-instellingen voor logboeken die u maakt met behulp van een TraceWriter object. Zie [C#-logboekregistratie] voor meer informatie.

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

watchDirectories

Een set gedeelde codemappen die moeten worden bewaakt voor wijzigingen. Zorgt ervoor dat wanneer code in deze mappen wordt gewijzigd, de wijzigingen worden opgehaald door uw functies.

{
    "watchDirectories": [ "Shared" ]
}

Volgende stappen