Справочник по файлу host.json для службы "Функции Azure" версии 1.xhost.json reference for Azure Functions 1.x

Файл метаданных host.json содержит параметры глобальной конфигурации, влияющие на все функции приложения-функции.The host.json metadata file contains global configuration options that affect all functions for a function app. В этой статье перечислены параметры, которые доступны для среды выполнения версии 1.This article lists the settings that are available for the v1 runtime. Схему JSON можно найти по адресу http://json.schemastore.org/host.The JSON schema is at http://json.schemastore.org/host.

Примечание

Эта статья предназначена для службы "Функции Azure" версии 1.x.This article is for Azure Functions 1.x. Ссылки на Host. JSON в функциях 2. x и более поздних версий см. в справочнике по Host. JSON для функций Azure 2. x.For a reference of host.json in Functions 2.x and later, see host.json reference for Azure Functions 2.x.

В параметрах приложения можно управлять другими настройками приложения-функции.Other function app configuration options are managed in your app settings.

Некоторые параметры host.json используются только при локальном запуске в файле local.settings.json.Some host.json settings are only used when running locally in the local.settings.json file.

Пример файла host.jsonSample host.json file

В приведенном ниже примере файлов host.json указаны все возможные параметры.The following sample host.json files have all possible options specified.

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

В следующих разделах этой статьи объясняется каждое свойство верхнего уровня.The following sections of this article explain each top-level property. Все они являются необязательными, если не указано иное.All are optional unless otherwise indicated.

aggregatoraggregator

Указывает, сколько вызовов функций обрабатывается при расчете метрик для Application Insights.Specifies how many function invocations are aggregated when calculating metrics for Application Insights.

{
    "aggregator": {
        "batchSize": 1000,
        "flushTimeout": "00:00:30"
    }
}
СвойствоProperty По умолчаниюDefault DescriptionDescription
batchSizebatchSize 10001000 Максимальное количество запросов, которое необходимо обработать.Maximum number of requests to aggregate.
flushTimeoutflushTimeout 00:00:3000:00:30 Максимальный период времени, который необходимо обработать.Maximum time period to aggregate.

Вызовы функций обрабатываются, когда достигается одно из этих двух ограничений.Function invocations are aggregated when the first of the two limits are reached.

applicationInsightsapplicationInsights

Управляет функцией выборки в Application Insights.Controls the sampling feature in Application Insights.

{
    "applicationInsights": {
        "sampling": {
          "isEnabled": true,
          "maxTelemetryItemsPerSecond" : 5
        }
    }
}
СвойствоProperty По умолчаниюDefault DescriptionDescription
isEnabledisEnabled truetrue Включает или отключает выборку.Enables or disables sampling.
maxTelemetryItemsPerSecondmaxTelemetryItemsPerSecond 55 Пороговое значение, при котором начинается выборка.The threshold at which sampling begins.

DocumentDBDocumentDB

Параметры конфигурации для триггера Azure Cosmos DB и привязок.Configuration settings for the Azure Cosmos DB trigger and bindings.

{
    "documentDB": {
        "connectionMode": "Gateway",
        "protocol": "Https",
        "leaseOptions": {
            "leasePrefix": "prefix1"
        }
    }
}
СвойствоProperty По умолчаниюDefault DescriptionDescription
GatewayModeGatewayMode ШлюзGateway Режим подключения, используемый функцией при подключении к службе Azure Cosmos DB.The connection mode used by the function when connecting to the Azure Cosmos DB service. Возможные значения: Direct и Gateway.Options are Direct and Gateway
ПротоколProtocol HttpsHttps Протокол подключения, используемый функцией при подключении к службе Azure Cosmos DB.The connection protocol used by the function when connection to the Azure Cosmos DB service. Описание обоих режимовRead here for an explanation of both modes
leasePrefixleasePrefix Н/Дn/a Префикс аренды для использования во всех функциях приложения.Lease prefix to use across all functions in an app.

durableTaskdurableTask

Параметры конфигурации для устойчивых функций.Configuration settings for Durable Functions.

Устойчивые функции 1. xDurable Functions 1.x

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

Устойчивые функции 2. xDurable Functions 2.x

{
  "durableTask": {
    "hubName": "MyTaskHub",
    "storageProvider": {
      "connectionStringName": "AzureWebJobsStorage",
      "controlQueueBatchSize": 32,
      "controlQueueBufferThreshold": 256,
      "controlQueueVisibilityTimeout": "00:05:00",
      "maxQueuePollingInterval": "00:00:30",
      "partitionCount": 4,
      "trackingStoreConnectionStringName": "TrackingStorage",
      "trackingStoreNamePrefix": "DurableTask",
      "workItemQueueVisibilityTimeout": "00:05:00",
    },
    "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",
          "Pending",
          "Failed",
          "Terminated"
        ]
      }
    },
    "maxConcurrentActivityFunctions": 10,
    "maxConcurrentOrchestratorFunctions": 10,
    "extendedSessionsEnabled": false,
    "extendedSessionIdleTimeoutInSeconds": 30,
    "useGracefulShutdown": false
  }
}

Имена центров задач должны начинаться с буквы и содержать только буквы и цифры.Task hub names must start with a letter and consist of only letters and numbers. Если имя не указано, центру задач в приложении-функции назначается имя по умолчанию DurableFunctionsHub.If not specified, the default task hub name for a function app is DurableFunctionsHub. Дополнительные сведения см. в статье о центрах задач.For more information, see Task hubs.

СвойствоProperty По умолчаниюDefault DescriptionDescription
hubNamehubName DurableFunctionsHubDurableFunctionsHub Альтернативные имена центра задач позволяют изолировать несколько приложений устойчивых функций друг от друга, даже если они используют один и тот же интерфейс хранилища.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.
контролкуеуебатчсизеcontrolQueueBatchSize 3232 Количество сообщений, одновременно извлекаемых из очереди управления.The number of messages to pull from the control queue at a time.
контролкуеуебуфферсрешолдcontrolQueueBufferThreshold 256256 Количество сообщений очереди управления, которые могут быть помещены в память за один раз, после чего диспетчер будет ожидать перед отправкой дополнительных сообщений.The number of control queue messages that can be buffered in memory at a time, at which point the dispatcher will wait before dequeuing any additional messages.
partitionCountpartitionCount 44 Число разделов для очереди управления.The partition count for the control queue. Допускается целочисленное значение в диапазоне от 1 до 16.May be a positive integer between 1 and 16.
контролкуеуевисибилититимеаутcontrolQueueVisibilityTimeout 5 мин5 minutes Время видимости для сообщений, выведенных из очереди управления.The visibility timeout of dequeued control queue messages.
воркитемкуеуевисибилититимеаутworkItemQueueVisibilityTimeout 5 мин5 minutes Время видимости для сообщений, выведенных из очереди рабочих элементов.The visibility timeout of dequeued work item queue messages.
максконкуррентактивитифунктионсmaxConcurrentActivityFunctions 10× количество процессоров на текущем компьютере10X the number of processors on the current machine Максимальное число функции действия, которые могут параллельно обрабатываться на одном экземпляре узла.The maximum number of activity functions that can be processed concurrently on a single host instance.
максконкурренторчестраторфунктионсmaxConcurrentOrchestratorFunctions 10× количество процессоров на текущем компьютере10X the number of processors on the current machine Максимальное количество функций оркестратора, которые могут быть обработаны параллельно в одном экземпляре узла.The maximum number of orchestrator functions that can be processed concurrently on a single host instance.
макскуеуеполлингинтервалmaxQueuePollingInterval 30 секунд30 seconds Максимальный интервал опроса управления и очереди рабочих элементов в формате чч: мм: СС .The maximum control and work-item queue polling interval in the hh:mm:ss format. Более высокие значения могут привести к увеличению задержек при обработке сообщений.Higher values can result in higher message processing latencies. Более низкие значения могут привести к более высоким затратам на хранение из-за увеличенных транзакций хранилища.Lower values can result in higher storage costs because of increased storage transactions.
азуресторажеконнектионстрингнамеazureStorageConnectionStringName AzureWebJobsStorageAzureWebJobsStorage Имя параметра приложения, в котором хранится строка подключения к службе хранилища Azure для управления базовыми ресурсами этой службы.The name of the app setting that has the Azure Storage connection string used to manage the underlying Azure Storage resources.
траккингстореконнектионстрингнамеtrackingStoreConnectionStringName Имя строки подключения, используемой для таблиц журнала и экземпляров.The name of a connection string to use for the History and Instances tables. Если не указано, используется подключение azureStorageConnectionStringName.If not specified, the azureStorageConnectionStringName connection is used.
траккингсторенамепрефиксtrackingStoreNamePrefix Префикс, используемый для таблиц журнала и экземпляров при указании trackingStoreConnectionStringName.The prefix to use for the History and Instances tables when trackingStoreConnectionStringName is specified. Если значение не задано, префикс по умолчанию будет DurableTask.If not set, the default prefix value will be DurableTask. Если trackingStoreConnectionStringName не указан, то таблицы журнала и экземпляров будут использовать в качестве префикса значение hubName, а любой параметр для trackingStoreNamePrefix будет проигнорирован.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.
трацеинпутсандаутпутсtraceInputsAndOutputs falsefalse Это значение указывает, нужно ли отслеживать входы и выходы вызовов функций.A value indicating whether to trace the inputs and outputs of function calls. При трассировке событий выполнения функции по умолчанию для вызовов функций фиксируется количество байтов в сериализованных входных и выходных данных.The default behavior when tracing function execution events is to include the number of bytes in the serialized inputs and outputs for function calls. Это поведение предоставляет минимальные сведения о том, как выглядят входные и выходные данные без чрезмерного перекрытия журналов или непреднамеренного предоставления конфиденциальной информации.This behavior provides minimal information about what the inputs and outputs look like without bloating the logs or inadvertently exposing sensitive information. Если вы присвоите этому свойству значение true, в журналы выполнения функций будет включаться полное содержимое их входов и выходов.Setting this property to true causes the default function logging to log the entire contents of function inputs and outputs.
логреплайевентсlogReplayEvents falsefalse Значение, указывающее, следует ли записывать повторные события оркестрации в Application Insights.A value indicating whether to write orchestration replay events to Application Insights.
евентгридтопицендпоинтeventGridTopicEndpoint URL-адрес конечной точки пользовательского раздела службы "Сетка событий Azure".The URL of an Azure Event Grid custom topic endpoint. Если это свойство задано, события уведомления о жизненном цикле оркестрации публикуются в этой конечной точке.When this property is set, orchestration life-cycle notification events are published to this endpoint. Это свойство поддерживает разрешение параметров приложения.This property supports App Settings resolution.
евентгридкэйсеттингнамеeventGridKeySettingName Имя параметра приложения, содержащего ключ для аутентификации в пользовательском разделе службы "Сетка событий Azure" в EventGridTopicEndpoint.The name of the app setting containing the key used for authenticating with the Azure Event Grid custom topic at EventGridTopicEndpoint.
евентгридпублишретрикаунтeventGridPublishRetryCount 00 Число повторных попыток, если публикация в разделе "Сетка событий" завершается сбоем.The number of times to retry if publishing to the Event Grid Topic fails.
евентгридпублишретринтервалeventGridPublishRetryInterval 5 мин5 minutes Интервал повторных попыток для публикации в разделе "Сетка событий" указывается в формате чч: мм:сс.The Event Grid publishes retry interval in the hh:mm:ss format.
евентгридпублишевенттипесeventGridPublishEventTypes Список типов событий для публикации в сетке событий.A list of event types to publish to Event Grid. Если не указано, будут опубликованы все типы событий.If not specified, all event types will be published. Допустимые значения: Started, Completed, Failed, Terminated.Allowed values include Started, Completed, Failed, Terminated.
усеграцефулшутдовнuseGracefulShutdown falsefalse Образца Включите корректное завершение работы, чтобы снизить вероятность того, что при завершении работы функции не удается завершить работу.(Preview) Enable gracefully shutting down to reduce the chance of host shutdowns failing in-process function executions.

Многие из этих параметров предназначены для оптимизации производительности.Many of these settings are for optimizing performance. Дополнительные сведения см. в статье о производительности и масштабируемости.For more information, see Performance and scale.

eventHubeventHub

Параметры конфигурации для триггеров и привязок концентратора событий.Configuration settings for Event Hub triggers and bindings.

{
    "eventHub": {
      "maxBatchSize": 64,
      "prefetchCount": 256,
      "batchCheckpointFrequency": 1
    }
}
СвойствоProperty значение по умолчаниюDefault ОписаниеDescription
maxBatchSizemaxBatchSize 6464 Максимальное число событий, получаемых в цикле получения.The maximum event count received per receive loop.
prefetchCountprefetchCount Недоступноn/a Значение PrefetchCount по умолчанию, которое будет использоваться базовым узлом EventProcessorHost.The default PrefetchCount that will be used by the underlying EventProcessorHost.
batchCheckpointFrequencybatchCheckpointFrequency 11 Количество пакетов событий, которые необходимо обработать перед созданием контрольной точки курсора EventHub.The number of event batches to process before creating an EventHub cursor checkpoint.

функцииfunctions

Список функций, которые выполняют узел заданий.A list of functions that the job host runs. Пустой массив означает выполнение всех функций.An empty array means run all functions. Предназначен для использования только при локальном выполнении.Intended for use only when running locally. Чтобы отключить определенные функции в приложениях-функциях Azure, выполните следующие действия в разделе Способы отключения функций в решении "Функции Azure" вместо использования этого параметра.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

Указывает время ожидания для всех функций.Indicates the timeout duration for all functions. В бессерверных планах потребления допускается диапазон от 1 секунды до 10 минут, а значение по умолчанию — 5 минут.In a serverless Consumption plan, the valid range is from 1 second to 10 minutes, and the default value is 5 minutes. В плане службы приложений нет общего ограничения, и значение по умолчанию равно null, что означает отсутствие времени ожидания.In an App Service plan, there is no overall limit and the default is null, which indicates no timeout.

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

healthMonitorhealthMonitor

Параметры конфигурации для монитора работоспособности узла.Configuration settings for Host health monitor.

{
    "healthMonitor": {
        "enabled": true,
        "healthCheckInterval": "00:00:10",
        "healthCheckWindow": "00:02:00",
        "healthCheckThreshold": 6,
        "counterThreshold": 0.80
    }
}
СвойствоProperty По умолчаниюDefault DescriptionDescription
Включеноenabled truetrue Указывает, включена ли функция.Specifies whether the feature is enabled.
healthCheckIntervalhealthCheckInterval 10 с10 seconds Интервал времени между периодическими фоновыми проверками работоспособности.The time interval between the periodic background health checks.
healthCheckWindowhealthCheckWindow 2 минуты2 minutes Скользящее окно времени, используемое в сочетании с параметром healthCheckThreshold.A sliding time window used in conjunction with the healthCheckThreshold setting.
healthCheckThresholdhealthCheckThreshold 66 Максимальное количество попыток проверки работоспособности, которые могут завершиться сбоем, прежде чем инициируется повторный запуск.Maximum number of times the health check can fail before a host recycle is initiated.
counterThresholdcounterThreshold 0,800.80 Пороговое значение, при достижении которого счетчик производительности будет считаться неработоспособным.The threshold at which a performance counter will be considered unhealthy.

httphttp

Параметры конфигурации для триггеров и привязок http.Configuration settings for http triggers and bindings.

{
    "http": {
        "routePrefix": "api",
        "maxOutstandingRequests": 200,
        "maxConcurrentRequests": 100,
        "dynamicThrottlesEnabled": true
    }
}
СвойствоProperty По умолчаниюDefault DescriptionDescription
dynamicThrottlesEnableddynamicThrottlesEnabled falsefalse Если этот параметр включен, он заставляет конвейер обработки запросов периодически проверять счетчики производительности системы (подключений, потоков, процессов, памяти, ЦП и т. д.). При превышении встроенного порогового высокого значения (80 %) любого из этих счетчиков запросы будут отклоняться с ответом "429 — cлишком много запросов" до тех пор, пока счетчики не вернутся к нормальному уровню.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.
maxConcurrentRequestsmaxConcurrentRequests без привязки (-1)unbounded (-1) Максимальное число функций HTTP, которые будут выполняться параллельно.The maximum number of HTTP functions that will be executed in parallel. Это позволяет регулировать параллелизм, что может помочь в управлении использованием ресурсов.This allows you to control concurrency, which can help manage resource utilization. Например, у вас может быть функция HTTP, которая использует большой объем системных ресурсов (память, ЦП и сокеты), что вызывает проблемы при слишком высоком уровне параллелизма.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. Или же функция может выполнять исходящие запросы к сторонней службе, и частоту таких вызовов необходимо ограничить.Or you might have a function that makes outbound requests to a third party service, and those calls need to be rate limited. В таких случаях может помочь применение регулирования.In these cases, applying a throttle here can help.
maxOutstandingRequestsmaxOutstandingRequests без привязки (-1)unbounded (-1) Максимальное число невыполненных запросов, которое хранится в любой отдельно взятый момент времени.The maximum number of outstanding requests that are held at any given time. Это ограничение включает запросы, которые находятся в очереди, но еще не начали выполняться, а также все запросы в процессе выполнения.This limit includes requests that are queued but have not started executing, as well as any in progress executions. Все входящие запросы, превышающие это ограничение, отклоняются с ответом 429 "Too Busy" (Перегрузка).Any incoming requests over this limit are rejected with a 429 "Too Busy" response. Это позволяет вызывающим объектам использовать стратегии повторов на основе времени, а также помогает вам контролировать максимальные задержки запросов.That allows callers to employ time-based retry strategies, and also helps you to control maximum request latencies. Эта настройка влияет только на очереди, которые создаются по пути выполнения средства обработки скриптов.This only controls queuing that occurs within the script host execution path. Она не влияет на другие очереди, такие как очередь запросов ASP.NET.Other queues such as the ASP.NET request queue will still be in effect and unaffected by this setting.
routePrefixroutePrefix apiapi Префикс маршрута, который применяется ко всем маршрутам.The route prefix that applies to all routes. Используйте пустую строку, чтобы удалить префикс по умолчанию.Use an empty string to remove the default prefix.

идентификаторid

Уникальный идентификатор для узла заданий.The unique ID for a job host. Это может быть глобальный уникальный идентификатор (GUID), вводимый в нижнем регистре с удаленными дефисами.Can be a lower case GUID with dashes removed. Необходим при локальном выполнении.Required when running locally. При работе в Azure, мы рекомендуем не задавать значение идентификатора.When running in Azure, we recommend that you not set an ID value. Идентификатор создается автоматически в Azure, когда id пропускается.An ID is generated automatically in Azure when id is omitted.

Если вы предоставляете общий доступ к учетной записи хранения для нескольких приложений-функций, убедитесь, что у всех них разные id.If you share a Storage account across multiple function apps, make sure that each function app has a different id. Вы можете опустить свойство id или вручную задать для id всех приложений-функций разные значения.You can omit the id property or manually set each function app's id to a different value. Для триггера таймера используется блокировка хранилища. Это гарантирует наличие только одного экземпляра таймера, когда приложение-функция масштабируется до нескольких экземпляров.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. Если у двух приложений-функций один id и для каждого используется триггер таймера, запустится только один таймер.If two function apps share the same id and each uses a timer trigger, only one timer will run.

{
    "id": "9f4ea53c5136457d883d685e57164f08"
}

loggerlogger

Управляет фильтрацией журналов, которые создаются объектом ILogger или context.log.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"
            }
        }
    }
}
СвойствоProperty По умолчаниюDefault DescriptionDescription
categoryFiltercategoryFilter Н/Дn/a Указывает параметры фильтрации по категории.Specifies filtering by category
defaultLeveldefaultLevel ИнформацияInformation Для любых категорий, не указанных в массиве categoryLevels, отправляет журналы на этом уровне и выше в Application Insights.For any categories not specified in the categoryLevels array, send logs at this level and above to Application Insights.
categoryLevelscategoryLevels Н/Дn/a Массив категорий, который определяет минимальный уровень ведения журнала для отправки в Application Insights для каждой категории.An array of categories that specifies the minimum log level to send to Application Insights for each category. Указанная здесь категория управляет всеми категориями, которые начинаются с одного значения, при этом более длинные значения имеют приоритет.The category specified here controls all categories that begin with the same value, and longer values take precedence. В предыдущем примере файла host.json все категории, которые начинаются с "Host.Aggregator", записываются в журнал на уровне Information.In the preceding sample host.json file, all categories that begin with "Host.Aggregator" log at Information level. Все прочие категории, которые начинаются с "Host" (такие как "Host.Executor"), записываются в журнал на уровне Error.All other categories that begin with "Host", such as "Host.Executor", log at Error level.

queuesqueues

Параметры конфигурации для триггеров и привязок очереди хранилища.Configuration settings for Storage queue triggers and bindings.

{
    "queues": {
      "maxPollingInterval": 2000,
      "visibilityTimeout" : "00:00:30",
      "batchSize": 16,
      "maxDequeueCount": 5,
      "newBatchThreshold": 8
    }
}
СвойствоProperty По умолчаниюDefault DescriptionDescription
maxPollingIntervalmaxPollingInterval 60 00060000 Максимальный интервал в миллисекундах между опросами очереди.The maximum interval in milliseconds between queue polls.
visibilityTimeoutvisibilityTimeout 00 Интервал времени между повторными попытками, когда при обработке сообщения возникает сбой.The time interval between retries when processing of a message fails.
batchSizebatchSize 1616 Количество сообщений очереди, которые среда выполнения функций одновременно получает и обрабатывает в параллельном режиме.The number of queue messages that the Functions runtime retrieves simultaneously and processes in parallel. Когда число обрабатываемых сообщений достигает newBatchThreshold, среда выполнения получает следующий пакет и начинает обработку содержащихся в нем сообщений.When the number being processed gets down to the newBatchThreshold, the runtime gets another batch and starts processing those messages. Поэтому максимальное количество сообщений, одновременно обрабатываемых каждой функцией, равно batchSize плюс newBatchThreshold.So the maximum number of concurrent messages being processed per function is batchSize plus newBatchThreshold. Это ограничение применяется отдельно к каждой функции, активируемой с помощью очереди.This limit applies separately to each queue-triggered function.

Если вы не хотите, чтобы сообщения из одной очереди обрабатывались параллельно, можно установить для batchSize значение 1.If you want to avoid parallel execution for messages received on one queue, you can set batchSize to 1. Тем не менее этот параметр позволяет исключить параллелизм только при условии, что приложение-функция выполняется на одной виртуальной машине.However, this setting eliminates concurrency only so long as your function app runs on a single virtual machine (VM). Если приложение-функция развернуто на нескольких виртуальных машинах, каждая машина может запускать один экземпляр каждой функции, активируемой с помощью очереди.If the function app scales out to multiple VMs, each VM could run one instance of each queue-triggered function.

Максимальное значение batchSize — 32.The maximum batchSize is 32.
maxDequeueCountmaxDequeueCount 55 Число повторных попыток обработки сообщения, прежде чем поместить его в очередь подозрительных сообщений.The number of times to try processing a message before moving it to the poison queue.
newBatchThresholdnewBatchThreshold batchSize/2batchSize/2 Каждый раз, когда количество сообщений, обрабатываемых параллельно, достигает этого числа, среда выполнения получает другой пакет.Whenever the number of messages being processed concurrently gets down to this number, the runtime retrieves another batch.

SendGridSendGrid

Параметр конфигурации для выходной привязки сендгриндConfiguration setting for the SendGrind output binding

{
    "sendGrid": {
        "from": "Contoso Group <admin@contoso.com>"
    }
СвойствоProperty По умолчаниюDefault DescriptionDescription
изfrom Н/Дn/a Адрес электронной почты для всех функций.The sender's email address across all functions.

serviceBusserviceBus

Параметр конфигурации для триггеров и привязок служебной шины.Configuration setting for Service Bus triggers and bindings.

{
    "serviceBus": {
      "maxConcurrentCalls": 16,
      "prefetchCount": 100,
      "autoRenewTimeout": "00:05:00"
    }
}
СвойствоProperty По умолчаниюDefault DescriptionDescription
maxConcurrentCallsmaxConcurrentCalls 1616 Максимальное число параллельных вызовов к обратному вызову, которое должен инициировать процесс обработки сообщений.The maximum number of concurrent calls to the callback that the message pump should initiate. По умолчанию в среде выполнения службы "Функции" одновременно обрабатывается несколько сообщений очереди.By default, the Functions runtime processes multiple messages concurrently. Чтобы среда выполнения обрабатывала в любой момент времени только одно сообщение очереди или раздела, для свойства maxConcurrentCalls нужно задать значение 1.To direct the runtime to process only a single queue or topic message at a time, set maxConcurrentCalls to 1.
prefetchCountprefetchCount Н/Дn/a Значение PrefetchCount по умолчанию, которое будет использоваться базовым компонентом MessageReceiver.The default PrefetchCount that will be used by the underlying MessageReceiver.
autoRenewTimeoutautoRenewTimeout 00:05:0000:05:00 Максимальный период времени, в течение которого блокировка сообщения будет продлеваться автоматически.The maximum duration within which the message lock will be renewed automatically.

singletonsingleton

Параметры конфигурации для одноэлементной блокировки.Configuration settings for Singleton lock behavior. Дополнительные сведения см. в проблеме, посвященной одноэлементной блокировке, на портале GitHub.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"
    }
}
СвойствоProperty По умолчаниюDefault DescriptionDescription
lockPeriodlockPeriod 00:00:1500:00:15 Период времени, на который применяются блокировки уровня функции.The period that function level locks are taken for. Эти блокировки возобновляются автоматически.The locks auto-renew.
listenerLockPeriodlistenerLockPeriod 00:01:0000:01:00 Период времени, на который применяются блокировки прослушивателя.The period that listener locks are taken for.
listenerLockRecoveryPollingIntervallistenerLockRecoveryPollingInterval 00:01:0000:01:00 Интервал времени, используемый для восстановления блокировки прослушивателя, если блокировку прослушивателя не удалось получить при запуске.The time interval used for listener lock recovery if a listener lock couldn't be acquired on startup.
lockAcquisitionTimeoutlockAcquisitionTimeout 00:01:0000:01:00 Максимальный период времени, за который среда выполнения будет пытаться получить блокировку.The maximum amount of time the runtime will try to acquire a lock.
lockAcquisitionPollingIntervallockAcquisitionPollingInterval Н/Дn/a Интервал между попытками получения блокировки.The interval between lock acquisition attempts.

tracingtracing

Версия 1.xVersion 1.x

Параметры конфигурации для журналов, создаваемых с помощью объекта TraceWriter.Configuration settings for logs that you create by using a TraceWriter object. Ознакомьтесь с разделами, посвященными ведению журналов, для C# и Node.js.See C# Logging and Node.js Logging.

{
    "tracing": {
      "consoleLevel": "verbose",
      "fileLoggingMode": "debugOnly"
    }
}
СвойствоProperty По умолчаниюDefault DescriptionDescription
consoleLevelconsoleLevel сведенияinfo Уровень трассировки для ведения журнала консоли.The tracing level for console logging. Доступны следующие параметры: off, error, warning, info и verbose.Options are: off, error, warning, info, and verbose.
fileLoggingModefileLoggingMode debugOnlydebugOnly Уровень трассировки для ведения журнала файлов.The tracing level for file logging. Доступны следующие параметры: never, always и debugOnly.Options are never, always, debugOnly.

watchDirectorieswatchDirectories

Набор каталогов общего кода, изменения которого должны отслеживаться.A set of shared code directories that should be monitored for changes. Гарантирует, что если код в этих каталогах изменится, то эти изменения будут применены вашими функциями.Ensures that when code in these directories is changed, the changes are picked up by your functions.

{
    "watchDirectories": [ "Shared" ]
}

Дальнейшие действияNext steps