host.json-Referenz für Azure Functions 1.xhost.json reference for Azure Functions 1.x

Die Metadatendatei host.json enthält globale Konfigurationsoptionen, die sich auf alle Funktionen einer Funktionen-App auswirken.The host.json metadata file contains global configuration options that affect all functions for a function app. In diesem Artikel werden die verfügbaren Einstellungen für die v1 Runtime aufgelistet.This article lists the settings that are available for the v1 runtime. Das JSON-Schema finden Sie unter http://json.schemastore.org/host.The JSON schema is at http://json.schemastore.org/host.

Hinweis

Dieser Artikel gilt für Azure Functions 1.x.This article is for Azure Functions 1.x. Eine Referenz für „host.json“ in Functions 2.x finden Sie unter host.json-Referenz für Azure Functions 2.x.For a reference of host.json in Functions 2.x, see host.json reference for Azure Functions 2.x.

Weitere Konfigurationsoptionen Ihrer Funktions-App werden in den Anwendungseinstellungen verwaltet.Other function app configuration options are managed in your app settings.

Einige Einstellungen in host.json werden nur bei lokaler Ausführung in der local.settings.json-Datei verwendet.Some host.json settings are only used when running locally in the local.settings.json file.

host.json-BeispieldateiSample host.json file

Für die folgenden host.json-Beispieldateien sind alle möglichen Optionen angegeben.The following sample host.json files have all possible options specified.

{
    "aggregator": {
        "batchSize": 1000,
        "flushTimeout": "00:00:30"
    },
    "applicationInsights": {
        "sampling": {
          "isEnabled": true,
          "maxTelemetryItemsPerSecond" : 5
        }
    },
    "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
    },
    "serviceBus": {
      "maxConcurrentCalls": 16,
      "prefetchCount": 100,
      "autoRenewTimeout": "00:05:00"
    },
    "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 den folgenden Abschnitten dieses Artikels werden die einzelnen allgemeinen Eigenschaften erläutert.The following sections of this article explain each top-level property. Alle Eigenschaften sind optional, sofern nicht anders angegeben.All are optional unless otherwise indicated.

aggregatoraggregator

Gibt an, wie viele Funktionsaufrufe aggregiert werden, wenn Metriken für Application Insights berechnet werden.Specifies how many function invocations are aggregated when calculating metrics for Application Insights.

{
    "aggregator": {
        "batchSize": 1000,
        "flushTimeout": "00:00:30"
    }
}
EigenschaftProperty StandardDefault BESCHREIBUNGDescription
batchSizebatchSize 10001000 Maximale Anzahl der zu aggregierenden Anforderungen.Maximum number of requests to aggregate.
flushTimeoutflushTimeout 00:00:3000:00:30 Maximal zu aggregierender Zeitraum.Maximum time period to aggregate.

Funktionsaufrufe werden aggregiert, wenn der erste der beiden Grenzwerte erreicht wird.Function invocations are aggregated when the first of the two limits are reached.

applicationInsightsapplicationInsights

Steuert das Stichprobenfeature in Application Insights.Controls the sampling feature in Application Insights.

{
    "applicationInsights": {
        "sampling": {
          "isEnabled": true,
          "maxTelemetryItemsPerSecond" : 5
        }
    }
}
EigenschaftProperty StandardDefault BESCHREIBUNGDescription
isEnabledisEnabled truetrue Aktiviert oder deaktiviert die Stichprobenentnahme.Enables or disables sampling.
maxTelemetryItemsPerSecondmaxTelemetryItemsPerSecond 55 Der Schwellenwert, bei dem die Stichprobenentnahme beginnt.The threshold at which sampling begins.

durableTaskdurableTask

Konfigurationseinstellungen für Durable Functions.Configuration settings for Durable Functions.

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

Aufgabenhubnamen müssen mit einem Buchstaben beginnen und bestehen nur aus Buchstaben und Ziffern.Task hub names must start with a letter and consist of only letters and numbers. Wenn nicht angegeben, lautet der standardmäßige Aufgabenhubname für eine Funktionen-App DurableFunctionsHub.If not specified, the default task hub name for a function app is DurableFunctionsHub. Weitere Informationen finden Sie unter Aufgabenhubs in Durable Functions (Azure Functions).For more information, see Task hubs.

EigenschaftProperty StandardDefault BESCHREIBUNGDescription
hubNamehubName DurableFunctionsHubDurableFunctionsHub Alternative Namen für Aufgabenhubs können zum Isolieren von mehreren Durable Functions-Anwendungen verwendet werden, auch wenn sie dasselbe Speicher-Back-End verwenden.Alternate task hub names can be used to isolate multiple Durable Functions applications from each other, even if they're using the same storage backend.
controlQueueBatchSizecontrolQueueBatchSize 3232 Die Anzahl der aus der Steuerelement-Warteschlange jeweils abzurufenden Nachrichten.The number of messages to pull from the control queue at a time.
partitionCountpartitionCount 44 Die Anzahl der Partitionen für die Steuerelement-Warteschlange.The partition count for the control queue. Kann ein positiver Integerwert zwischen 1 und 16 sein.May be a positive integer between 1 and 16.
controlQueueVisibilityTimeoutcontrolQueueVisibilityTimeout 5 Minuten5 minutes Das Sichtbarkeitstimeout von aus der Steuerelement-Warteschlange entfernten Nachrichten.The visibility timeout of dequeued control queue messages.
workItemQueueVisibilityTimeoutworkItemQueueVisibilityTimeout 5 Minuten5 minutes Das Sichtbarkeitstimeout von aus der Warteschlange für Arbeitselemente (work item queue) entfernten Nachrichten.The visibility timeout of dequeued work item queue messages.
maxConcurrentActivityFunctionsmaxConcurrentActivityFunctions Zehnfache Anzahl der Prozessoren auf dem aktuellen Computer10X the number of processors on the current machine Die maximale Anzahl von Aktivitätsfunktionen, die gleichzeitig auf einer einzelnen Hostinstanz verarbeitet werden können.The maximum number of activity functions that can be processed concurrently on a single host instance.
maxConcurrentOrchestratorFunctionsmaxConcurrentOrchestratorFunctions Zehnfache Anzahl der Prozessoren auf dem aktuellen Computer10X the number of processors on the current machine Die maximale Anzahl von Orchestratorfunktionen, die gleichzeitig auf einer einzelnen Hostinstanz verarbeitet werden können.The maximum number of orchestrator functions that can be processed concurrently on a single host instance.
maxQueuePollingIntervalmaxQueuePollingInterval 30 Sekunden30 seconds Das maximale Abrufintervall der Steuerelement- und Arbeitselement-Warteschlangen im Format hh:mm:ss.The maximum control and work-item queue polling interval in the hh:mm:ss format. Höhere Werte können zu höherer Latenz bei der Nachrichtenverarbeitung führen.Higher values can result in higher message processing latencies. Niedrigere Werte können aufgrund verstärkter Speichertransaktionen zu höheren Speicherkosten führen.Lower values can result in higher storage costs because of increased storage transactions.
azureStorageConnectionStringNameazureStorageConnectionStringName AzureWebJobsStorageAzureWebJobsStorage Der Name der App-Einstellung mit der Azure Storage-Verbindungszeichenfolge, die zum Verwalten der zugrunde liegenden Azure Storage-Ressourcen verwendet wird.The name of the app setting that has the Azure Storage connection string used to manage the underlying Azure Storage resources.
trackingStoreConnectionStringNametrackingStoreConnectionStringName Der Name einer Verbindungszeichenfolge, die für die Verlaufs- und Instanzentabellen verwendet wird.The name of a connection string to use for the History and Instances tables. Wenn diese Eigenschaft nicht angegeben ist, wird die Verbindung azureStorageConnectionStringName verwendet.If not specified, the azureStorageConnectionStringName connection is used.
trackingStoreNamePrefixtrackingStoreNamePrefix Das für die Verlaufs- und Instanzentabellen zu verwendende Präfix, wenn trackingStoreConnectionStringName angegeben ist.The prefix to use for the History and Instances tables when trackingStoreConnectionStringName is specified. Wenn diese Eigenschaft nicht festgelegt ist, wird DurableTask als Standardwert für das Präfix verwendet.If not set, the default prefix value will be DurableTask. Wenn trackingStoreConnectionStringName nicht angegeben ist, wird in den Verlaufs- und Instanzentabellen der Wert hubName als Präfix verwendet und jede Einstellung für trackingStoreNamePrefix wird ignoriert.If trackingStoreConnectionStringName is not specified, then the History and Instances tables will use the hubName value as their prefix, and any setting for trackingStoreNamePrefix will be ignored.
traceInputsAndOutputstraceInputsAndOutputs falsefalse Ein Wert, der angibt, ob die Eingaben und Ausgaben von Funktionsaufrufen nachverfolgt werden.A value indicating whether to trace the inputs and outputs of function calls. Das Standardverhalten beim Nachverfolgen von Ereignissen zur Funktionsausführung besteht darin, die Anzahl der Bytes in die serialisierten Eingaben und Ausgaben für Funktionsaufrufe einzuschließen.The default behavior when tracing function execution events is to include the number of bytes in the serialized inputs and outputs for function calls. Dieses Verhalten ermöglicht minimale Informationen zu den Eingaben und Ausgaben, ohne die Protokolle zu überfrachten oder irrtümlich vertrauliche Informationen verfügbar zu machen.This behavior provides minimal information about what the inputs and outputs look like without bloating the logs or inadvertently exposing sensitive information. Wenn diese Eigenschaft auf TRUE festgelegt wird, werden bei der standardmäßigen Funktionsprotokollierung die gesamten Inhalte der Eingaben und Ausgaben der Funktionen protokolliert.Setting this property to true causes the default function logging to log the entire contents of function inputs and outputs.
logReplayEventslogReplayEvents falsefalse Ein Wert, der angibt, ob Orchestrierungswiedergabeereignisse in Application Insights geschrieben werden.A value indicating whether to write orchestration replay events to Application Insights.
eventGridTopicEndpointeventGridTopicEndpoint Die URL eines benutzerdefinierten Azure Event Grid-Themenendpunkts.The URL of an Azure Event Grid custom topic endpoint. Wenn diese Eigenschaft festgelegt ist, werden Benachrichtigungsereignisse zum Orchestrierungslebenszyklus an diesem Endpunkt veröffentlicht.When this property is set, orchestration life-cycle notification events are published to this endpoint. Diese Eigenschaft unterstützt die Auflösung von App-Einstellungen.This property supports App Settings resolution.
eventGridKeySettingNameeventGridKeySettingName Der Name der App-Einstellung, die den Schlüssel für die Authentifizierung mit dem benutzerdefinierten Azure Event Grid-Thema unter EventGridTopicEndpoint enthält.The name of the app setting containing the key used for authenticating with the Azure Event Grid custom topic at EventGridTopicEndpoint.
eventGridPublishRetryCounteventGridPublishRetryCount 00 Die Anzahl der Wiederholungsversuche, wenn bei der Veröffentlichung im Event Grid-Thema Fehler auftreten.The number of times to retry if publishing to the Event Grid Topic fails.
eventGridPublishRetryIntervaleventGridPublishRetryInterval 5 Minuten5 minutes Das Wiederholungsintervall der Event Grid-Veröffentlichung im Format hh:mm:ss.The Event Grid publishes retry interval in the hh:mm:ss format.
eventGridPublishEventTypeseventGridPublishEventTypes Eine Liste von Ereignistypen, die in Event Grid veröffentlicht werden sollen.A list of event types to publish to Event Grid. Wenn diese Eigenschaft nicht angegeben ist, werden alle Ereignistypen veröffentlicht.If not specified, all event types will be published. Zulässige Werte sind Started, Completed, Failed und Terminated.Allowed values include Started, Completed, Failed, Terminated.

Viele dieser Einstellungen werden zur Optimierung der Leistung verwendet.Many of these settings are for optimizing performance. Weitere Informationen finden Sie unter Leistung und Skalierbarkeit.For more information, see Performance and scale.

eventHubeventHub

Konfigurationseinstellungen für Event Hub-Trigger und -Bindungen.Configuration settings for Event Hub triggers and bindings.

{
    "eventHub": {
      "maxBatchSize": 64,
      "prefetchCount": 256,
      "batchCheckpointFrequency": 1
    }
}
EigenschaftProperty StandardDefault BESCHREIBUNGDescription
maxBatchSizemaxBatchSize 6464 Die maximale Ereignisanzahl, die pro Empfangsschleife empfangen wird.The maximum event count received per receive loop.
prefetchCountprefetchCount n/a Das standardmäßige PrefetchCount, das von dem zugrunde liegenden EventProcessorHost verwendet wird.The default PrefetchCount that will be used by the underlying EventProcessorHost.
batchCheckpointFrequencybatchCheckpointFrequency 11 Die Anzahl der zu verarbeitenden Ereignisbatches, bevor ein EventHub-Cursorprüfpunkt erstellt wird.The number of event batches to process before creating an EventHub cursor checkpoint.

functionsfunctions

Eine Liste der Funktionen, die vom Auftragshost ausgeführt werden.A list of functions that the job host runs. Ein leeres Array bedeutet, dass alle Funktionen ausgeführt werden.An empty array means run all functions. Nur bei lokaler Ausführung für die Verwendung vorgesehen.Intended for use only when running locally. In Funktions-Apps in Azure sollten Sie anstelle dieser Einstellung die in How to disable functions in Azure Functions (Deaktivieren von Funktionen in Azure Functions) aufgeführten Schritte ausführen, um bestimmte Funktionen zu deaktivieren.In function apps in Azure, you should instead follow the steps in How to disable functions in Azure Functions to disable specific functions rather than using this setting.

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

functionTimeoutfunctionTimeout

Gibt die Timeoutdauer für alle Funktionen an.Indicates the timeout duration for all functions. Bei einem serverlosen Verbrauchsplan liegt der gültige Bereich zwischen 1 Sekunde und 10 Minuten, wobei der Standardwert bei 5 Minuten liegt.In a serverless Consumption plan, the valid range is from 1 second to 10 minutes, and the default value is 5 minutes. Bei einem App Service-Plan gibt es keine allgemeine Beschränkung, und der Standardwert hängt von der Version der Runtime ab.In an App Service plan, there is no overall limit and the default depends on the runtime version.

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

healthMonitorhealthMonitor

Konfigurationseinstellungen für Host Health Monitor (Überwachung der Hostintegrität).Configuration settings for Host health monitor.

{
    "healthMonitor": {
        "enabled": true,
        "healthCheckInterval": "00:00:10",
        "healthCheckWindow": "00:02:00",
        "healthCheckThreshold": 6,
        "counterThreshold": 0.80
    }
}
EigenschaftProperty StandardDefault BESCHREIBUNGDescription
enabledenabled truetrue Gibt an, ob die Funktion aktiviert ist.Specifies whether the feature is enabled.
healthCheckIntervalhealthCheckInterval 10 Sekunden10 seconds Das Zeitintervall zwischen den regelmäßigen Integritätsüberprüfungen im Hintergrund.The time interval between the periodic background health checks.
healthCheckWindowhealthCheckWindow 2 Minuten2 minutes Ein variables Zeitfenster, das in Zusammenhang mit der healthCheckThreshold-Einstellung verwendet wird.A sliding time window used in conjunction with the healthCheckThreshold setting.
healthCheckThresholdhealthCheckThreshold 66 Maximale Anzahl von fehlerhaften Integritätsüberprüfungen, bevor ein Neustart des Hosts initiiert wird.Maximum number of times the health check can fail before a host recycle is initiated.
counterThresholdcounterThreshold 0.800.80 Der Schwellenwert, an dem ein Leistungsindikator als fehlerhaft betrachtet wird.The threshold at which a performance counter will be considered unhealthy.

httphttp

Konfigurationseinstellungen für HTTP-Trigger und -Bindungen.Configuration settings for http triggers and bindings.

{
    "http": {
        "routePrefix": "api",
        "maxOutstandingRequests": 200,
        "maxConcurrentRequests": 100,
        "dynamicThrottlesEnabled": true
    }
}
EigenschaftProperty StandardDefault BESCHREIBUNGDescription
routePrefixroutePrefix apiapi Das Routenpräfix, das für alle Routen gilt.The route prefix that applies to all routes. Verwenden Sie eine leere Zeichenfolge, um das Standardpräfix zu entfernen.Use an empty string to remove the default prefix.
maxOutstandingRequestsmaxOutstandingRequests 200*200* Die maximale Anzahl ausstehender Anforderungen, die zu einem beliebigen Zeitpunkt gespeichert werden.The maximum number of outstanding requests that are held at any given time. Dieser Grenzwert umfasst Anforderungen in der Warteschlange, deren Ausführung aber noch nicht gestartet ist, sowie alle laufenden Ausführungen.This limit includes requests that are queued but have not started executing, as well as any in progress executions. Alle eingehenden Anforderungen über diesem Grenzwert werden mit der Antwort 429 „Ausgelastet“ zurückgewiesen.Any incoming requests over this limit are rejected with a 429 "Too Busy" response. Das ermöglicht es dem Aufrufer zeitbasierte Strategien für Wiederholungsversuche einzusetzen, und Sie erhalten damit die Möglichkeit, die maximalen Wartezeiten für Anforderungen zu steuern.That allows callers to employ time-based retry strategies, and also helps you to control maximum request latencies. Damit wird nur das Queuing gesteuert, das innerhalb des Ausführungspfads des Skripthosts auftritt.This only controls queuing that occurs within the script host execution path. Andere Warteschlangen, z.B. die ASP.NET-Anforderungswarteschlange, sind von dieser Einstellung nicht betroffen und werden weiterhin verwendet.Other queues such as the ASP.NET request queue will still be in effect and unaffected by this setting. *Der Standardwert für Version 1.x ist unbegrenzt (-1).*The default for version 1.x is unbounded (-1). Der Standardwert für Version 2.x in einem Verbrauchstarif beträgt 200.The default for version 2.x in a consumption plan is 200. Der Standardwert für Version 2.x in einem dedizierten Plan ist unbegrenzt (-1).The default for version 2.x in a dedicated plan is unbounded (-1).
maxConcurrentRequestsmaxConcurrentRequests 100*100* Die maximale Anzahl von HTTP-Funktionen, die parallel ausgeführt werden.The maximum number of http functions that will be executed in parallel. Dadurch können Sie die Parallelität steuern und somit die Verwaltung der Ressourcenverwendung vereinfachen.This allows you to control concurrency, which can help manage resource utilization. Beispielsweise könnten Sie über eine HTTP-Funktion verfügen, die viele Systemressourcen (Speicher/CPU/Sockets) verbraucht und daher Probleme verursacht, wenn die Parallelität zu hoch ist.For example, you might have an http function that uses a lot of system resources (memory/cpu/sockets) such that it causes issues when concurrency is too high. Oder eine Funktion führt ausgehende Anforderungen an einen Dienst eines Drittanbieters durch, und die Rate dieser Aufrufe muss eingeschränkt werden.Or you might have a function that makes outbound requests to a third party service, and those calls need to be rate limited. In diesen Fällen kann eine Drosselung hilfreich sein.In these cases, applying a throttle here can help. *Der Standardwert für Version 1.x ist unbegrenzt (-1).*The default for version 1.x is unbounded (-1). Der Standardwert für Version 2.x in einem Verbrauchstarif beträgt 100.The default for version 2.x in a consumption plan is 100. Der Standardwert für Version 2.x in einem dedizierten Plan ist unbegrenzt (-1).The default for version 2.x in a dedicated plan is unbounded (-1).
dynamicThrottlesEnableddynamicThrottlesEnabled true*true* Bei einer Aktivierung dieser Einstellung überprüft die Pipeline zur Anforderungsverarbeitung regelmäßig Leistungsindikatoren zur Systemleistung wie Verbindungen/Threads/Prozesse/Speicher/CPU usw., und wenn einer dieser Leistungsindikatoren einen integrierten Schwellenwert (80 %) übersteigt, werden Anforderungen mit der Antwort „429 – Ausgelastet“ zurückgewiesen, bis die Leistungsindikatoren wieder ein normales Niveau erreichen.When enabled, this setting causes the request processing pipeline to periodically check system performance counters like connections/threads/processes/memory/cpu/etc. and if any of those counters are over a built-in high threshold (80%), requests will be rejected with a 429 "Too Busy" response until the counter(s) return to normal levels. *Der Standardwert für Version 1.x lautet „false“.*The default for version 1.x is false. Der Standardwert für Version 2.x in einem Verbrauchstarif lautet „true“.The default for version 2.x in a consumption plan is true. Der Standardwert für Version 2.x in einem dedizierten Tarif lautet „false“.The default for version 2.x in a dedicated plan is false.

idid

Nur Version 1.x.Version 1.x only.

Die eindeutige ID für einen Auftragshost.The unique ID for a job host. Die kann eine GUID in Kleinbuchstaben mit entfernten Bindestrichen sein.Can be a lower case GUID with dashes removed. Dies ist für die lokale Ausführung erforderlich.Required when running locally. Bei der Ausführung in Azure empfehlen wir, keinen ID-Wert festzulegen.When running in Azure, we recommend that you not set an ID value. Wenn id nicht angegeben ist, wird in Azure automatisch eine ID generiert.An ID is generated automatically in Azure when id is omitted.

Wenn Sie ein Speicherkonto für mehrere Funktions-Apps verwenden, stellen Sie sicher, dass jede Funktions-App einen anderen Wert für id aufweist.If you share a Storage account across multiple function apps, make sure that each function app has a different id. Sie können die id-Eigenschaft auslassen oder id für jede Funktions-App manuell auf einen anderen Wert festlegen.You can omit the id property or manually set each function app's id to a different value. Der Trigger mit Timer verwendet eine Speichersperre, um sicherzustellen, dass nur eine Timerinstanz vorhanden ist, wenn eine Funktions-App auf mehrere Instanzen horizontal hochskaliert wird.The timer trigger uses a storage lock to ensure that there will be only one timer instance when a function app scales out to multiple instances. Wenn zwei Funktions-Apps denselben id-Wert aufweisen und beide einen Trigger mit Timer verwenden, wird nur ein Timer ausgeführt.If two function apps share the same id and each uses a timer trigger, only one timer will run.

{
    "id": "9f4ea53c5136457d883d685e57164f08"
}

Protokollierungstoollogger

Steuerelemente, die nach Protokollen filtern, die von einem ILogger-Objekt oder von context.log geschrieben werden.Controls filtering for logs written by an ILogger object or by context.log.

{
    "logger": {
        "categoryFilter": {
            "defaultLevel": "Information",
            "categoryLevels": {
                "Host": "Error",
                "Function": "Error",
                "Host.Aggregator": "Information"
            }
        }
    }
}
EigenschaftProperty StandardDefault BESCHREIBUNGDescription
categoryFiltercategoryFilter n/a Gibt die Filterung nach Kategorie an.Specifies filtering by category
defaultLeveldefaultLevel InformationInformation Für alle nicht im categoryLevels-Array angegebenen Kategorien, werden Protokolle auf dieser und darüber liegenden Ebenen an Application Insights gesendet.For any categories not specified in the categoryLevels array, send logs at this level and above to Application Insights.
categoryLevelscategoryLevels n/a Ein Array von Kategorien, das den minimalen Protokolliergrad angibt, der für die einzelnen Kategorien an Application Insights gesendet wird.An array of categories that specifies the minimum log level to send to Application Insights for each category. Die hier angegebene Kategorie steuert alle Kategorien, die mit demselben Wert beginnen und längere Werte haben Vorrang.The category specified here controls all categories that begin with the same value, and longer values take precedence. In der vorhergehenden host.json-Beispieldatei werden alle Kategorien, die mit „Host.Aggregator“ beginnen, auf der Information-Ebene protokolliert.In the preceding sample host.json file, all categories that begin with "Host.Aggregator" log at Information level. Alle anderen Kategorien, die mit „Host“ beginnen, z. B. „Host.Executor“, werden auf der Error-Ebene protokolliert.All other categories that begin with "Host", such as "Host.Executor", log at Error level.

queuesqueues

Konfigurationseinstellungen für Trigger und Bindungen der Speicherwarteschlange.Configuration settings for Storage queue triggers and bindings.

{
    "queues": {
      "maxPollingInterval": 2000,
      "visibilityTimeout" : "00:00:30",
      "batchSize": 16,
      "maxDequeueCount": 5,
      "newBatchThreshold": 8
    }
}
EigenschaftProperty StandardDefault BESCHREIBUNGDescription
maxPollingIntervalmaxPollingInterval 6000060000 Das maximale Intervall in Millisekunden zwischen Warteschlangenumfragen.The maximum interval in milliseconds between queue polls.
visibilityTimeoutvisibilityTimeout 00 Das Zeitintervall zwischen Wiederholungsversuchen, wenn bei der Verarbeitung einer Nachricht ein Fehler auftritt.The time interval between retries when processing of a message fails.
batchSizebatchSize 1616 Die Anzahl der Warteschlangennachrichten, die die Functions-Runtime gleichzeitig abruft und parallel verarbeitet.The number of queue messages that the Functions runtime retrieves simultaneously and processes in parallel. Wenn die zu verarbeitende Anzahl newBatchThreshold erreicht, ruft die Runtime einen weiteren Batch ab und beginnt mit der Verarbeitung dieser Nachrichten.When the number being processed gets down to the newBatchThreshold, the runtime gets another batch and starts processing those messages. Aus diesem Grund beträgt die maximale Anzahl der pro Funktion verarbeiteten Nachrichten batchSize plus newBatchThreshold.So the maximum number of concurrent messages being processed per function is batchSize plus newBatchThreshold. Dieser Grenzwert gilt separat für jede Funktion, die durch die Warteschlange ausgelöst wird.This limit applies separately to each queue-triggered function.

Wenn Sie eine parallele Ausführung für in einer Warteschlange empfangene Nachrichten vermeiden möchten, können Sie batchSize auf „1“ festlegen.If you want to avoid parallel execution for messages received on one queue, you can set batchSize to 1. Diese Einstellung verhindert Parallelität jedoch nur so lange, wie Ihre Funktions-App auf einem einzelnen virtuellen Computer (VM) ausgeführt wird.However, this setting eliminates concurrency only so long as your function app runs on a single virtual machine (VM). Wenn die Funktions-App horizontal auf mehrere virtuelle Computer hochskaliert wird, kann jeder virtuelle Computer eine Instanz jeder durch die Warteschlange ausgelösten Funktion ausführen.If the function app scales out to multiple VMs, each VM could run one instance of each queue-triggered function.

Die maximale batchSize beträgt 32.The maximum batchSize is 32.
maxDequeueCountmaxDequeueCount 55 Die Anzahl der Versuche zum Verarbeiten einer Nachricht, bevor diese in die Warteschlange für nicht verarbeitete Nachrichten verschoben wird.The number of times to try processing a message before moving it to the poison queue.
newBatchThresholdnewBatchThreshold batchSize/2batchSize/2 Wenn die Anzahl der gleichzeitig verarbeiteten Nachrichten auf diesen Wert sinkt, ruft die Runtime einen weiteren Batch ab.Whenever the number of messages being processed concurrently gets down to this number, the runtime retrieves another batch.

serviceBusserviceBus

Konfigurationseinstellung für Service Bus-Trigger und -Bindungen.Configuration setting for Service Bus triggers and bindings.

{
    "serviceBus": {
      "maxConcurrentCalls": 16,
      "prefetchCount": 100,
      "autoRenewTimeout": "00:05:00"
    }
}
EigenschaftProperty StandardDefault BESCHREIBUNGDescription
maxConcurrentCallsmaxConcurrentCalls 1616 Die maximale Anzahl gleichzeitiger Aufrufe für den Rückruf, der vom Nachrichtensystem initiiert werden soll.The maximum number of concurrent calls to the callback that the message pump should initiate. Die Functions-Runtime verarbeitet standardmäßig mehrere Nachrichten gleichzeitig.By default, the Functions runtime processes multiple messages concurrently. Um die Runtime anzuweisen, jeweils nur eine Warteschlangen- oder Themennachricht zu verarbeiten, legen Sie maxConcurrentCalls auf „1“ fest.To direct the runtime to process only a single queue or topic message at a time, set maxConcurrentCalls to 1.
prefetchCountprefetchCount n/a Das standardmäßige PrefetchCount, das von dem zugrunde liegenden MessageReceiver verwendet wird.The default PrefetchCount that will be used by the underlying MessageReceiver.
autoRenewTimeoutautoRenewTimeout 00:05:0000:05:00 Die maximale Zeitspanne, in der die Nachrichtensperre automatisch erneuert wird.The maximum duration within which the message lock will be renewed automatically.

singletonsingleton

Konfigurationseinstellungen für das Singleton-Sperrverhalten.Configuration settings for Singleton lock behavior. Weitere Informationen finden Sie unter GitHub-Problem zur Singleton-Unterstützung.For more information, see GitHub issue about singleton support.

{
    "singleton": {
      "lockPeriod": "00:00:15",
      "listenerLockPeriod": "00:01:00",
      "listenerLockRecoveryPollingInterval": "00:01:00",
      "lockAcquisitionTimeout": "00:01:00",
      "lockAcquisitionPollingInterval": "00:00:03"
    }
}
EigenschaftProperty StandardDefault BESCHREIBUNGDescription
lockPeriodlockPeriod 00:00:1500:00:15 Der Zeitraum, für den Sperren auf Funktionsebene gelten.The period that function level locks are taken for. Die Sperren werden automatisch verlängert.The locks auto-renew.
listenerLockPeriodlistenerLockPeriod 00:01:0000:01:00 Der Zeitraum, für den Listenersperren gelten.The period that listener locks are taken for.
listenerLockRecoveryPollingIntervallistenerLockRecoveryPollingInterval 00:01:0000:01:00 Das Zeitintervall für die Wiederherstellung der Listenersperre, wenn eine Listenersperre nicht beim Start abgerufen werden konnte.The time interval used for listener lock recovery if a listener lock couldn't be acquired on startup.
lockAcquisitionTimeoutlockAcquisitionTimeout 00:01:0000:01:00 Die maximale Zeitspanne, in der die Laufzeit versucht, eine Sperre abzurufen.The maximum amount of time the runtime will try to acquire a lock.
lockAcquisitionPollingIntervallockAcquisitionPollingInterval n/a Das Intervall zwischen den Versuchen, eine Sperre abzurufen.The interval between lock acquisition attempts.

tracingtracing

Version 1.xVersion 1.x

Konfigurationseinstellungen für Protokolle, die Sie mithilfe eines TraceWriter-Objekts erstellen.Configuration settings for logs that you create by using a TraceWriter object. Weitere Informationen finden Sie unter C#-Protokollierung und Node.js-Protokollierung.See C# Logging and Node.js Logging.

{
    "tracing": {
      "consoleLevel": "verbose",
      "fileLoggingMode": "debugOnly"
    }
}
EigenschaftProperty StandardDefault BESCHREIBUNGDescription
consoleLevelconsoleLevel infoinfo Die Ablaufverfolgungsebene für die Konsolenprotokollierung.The tracing level for console logging. Optionen sind: off, error, warning, info und verbose.Options are: off, error, warning, info, and verbose.
fileLoggingModefileLoggingMode debugOnlydebugOnly Die Ablaufverfolgungsebene für die Dateiprotokollierung.The tracing level for file logging. Optionen sind never, always, debugOnly.Options are never, always, debugOnly.

watchDirectorieswatchDirectories

Eine Reihe von Verzeichnissen mit freigegebenem Code, die auf Änderungen überwacht werden sollte.A set of shared code directories that should be monitored for changes. Dadurch wird sichergestellt, dass Änderungen am Code in diesen Verzeichnissen von Ihren Funktionen übernommen werden.Ensures that when code in these directories is changed, the changes are picked up by your functions.

{
    "watchDirectories": [ "Shared" ]
}

Nächste SchritteNext steps