Dokumentacja pliku host.json dla usługi Azure Functions 1.x

Artykuł
10/18/2023

Plik metadanych host.json zawiera opcje konfiguracji, które mają wpływ na wszystkie funkcje w wystąpieniu aplikacji funkcji. W tym artykule wymieniono ustawienia dostępne dla środowiska uruchomieniowego w wersji 1.x. Schemat JSON ma wartość .http://json.schemastore.org/host

Uwaga

Ten artykuł dotyczy usługi Azure Functions 1.x. Aby zapoznać się z dokumentacją pliku host.json w usłudze Functions 2.x lub nowszym, zobacz dokumentacja pliku host.json dla usługi Azure Functions 2.x.

Inne opcje konfiguracji aplikacji funkcji są zarządzane w ustawieniach aplikacji.

Niektóre ustawienia pliku host.json są używane tylko w przypadku uruchamiania lokalnego w pliku local.settings.json .

Przykładowy plik host.json

Następujące przykładowe pliki host.json mają określone wszystkie możliwe opcje.

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

W poniższych sekcjach tego artykułu opisano każdą właściwość najwyższego poziomu. Wszystkie są opcjonalne, chyba że wskazano inaczej.

Agregator

Określa, ile wywołań funkcji jest agregowanych podczas obliczania metryk dla aplikacji Szczegółowe informacje.

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

Właściwości	Domyślny	opis
batchSize	1000	Maksymalna liczba żądań do agregowania.
flushTimeout	00:00:30	Maksymalny okres do agregowania.

Wywołania funkcji są agregowane po osiągnięciu pierwszego z dwóch limitów.

application Szczegółowe informacje

Steruje funkcją próbkowania w aplikacji Szczegółowe informacje.

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

Właściwości	Domyślny	opis
Isenabled	true	Włącza lub wyłącza próbkowanie.
maxTelemetryItemsPerSecond	5	Próg, na którym rozpoczyna się próbkowanie.

DocumentDB

Ustawienia konfiguracji wyzwalacza i powiązań usługi Azure Cosmos DB.

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

Właściwości	Domyślny	opis
GatewayMode	Brama	Tryb połączenia używany przez funkcję podczas nawiązywania połączenia z usługą Azure Cosmos DB. Opcje to `Direct` i `Gateway`
Protokół	Https	Protokół połączenia używany przez funkcję podczas nawiązywania połączenia z usługą Azure Cosmos DB. Przeczytaj tutaj, aby uzyskać wyjaśnienie obu trybów
leasePrefix	nie dotyczy	Prefiks dzierżawy do użycia we wszystkich funkcjach w aplikacji.

durableTask

Ustawienia konfiguracji rozszerzenia Durable Functions.

Uwaga

Wszystkie główne wersje rozszerzenia Durable Functions są obsługiwane we wszystkich wersjach środowiska uruchomieniowego usługi Azure Functions. Jednak schemat konfiguracji host.json jest nieco inny w zależności od wersji środowiska uruchomieniowego usługi Azure Functions i używanej wersji rozszerzenia Durable Functions. Poniższe przykłady służą do użycia z usługami Azure Functions 2.0 i 3.0. W obu przykładach, jeśli używasz usługi Azure Functions 1.0, dostępne ustawienia są takie same, ale sekcja "durableTask" pliku host.json powinna znajdować się w katalogu głównym konfiguracji host.json zamiast jako pole w obszarze "extensions".

Durable Functions 2.x
Durable Functions 1.x

{
 "extensions": {
  "durableTask": {
    "hubName": "MyTaskHub",
    "storageProvider": {
      "connectionStringName": "AzureWebJobsStorage",
      "controlQueueBatchSize": 32,
      "controlQueueBufferThreshold": 256,
      "controlQueueVisibilityTimeout": "00:05:00",
      "maxQueuePollingInterval": "00:00:30",
      "partitionCount": 4,
      "trackingStoreConnectionStringName": "TrackingStorage",
      "trackingStoreNamePrefix": "DurableTask",
      "useLegacyPartitionManagement": true,
      "useTablePartitionManagement": false,
      "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,
    "useAppLease": true,
    "useGracefulShutdown": false,
    "maxEntityOperationBatchSize": 50,
    "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"]
    }
  }
}

Nazwy centrum zadań muszą zaczynać się literą i składać się tylko z liter i cyfr. Jeśli nie zostanie określona, domyślna nazwa centrum zadań dla aplikacji funkcji to TestHubName. Aby uzyskać więcej informacji, zobacz Centra zadań.

Właściwości	Domyślny	opis
hubName	TestHubName (DurableFunctionsHub, jeśli używasz rozszerzenia Durable Functions 1.x)	Alternatywne nazwy centrum zadań mogą służyć do izolowania wielu aplikacji Durable Functions od siebie, nawet jeśli używają tego samego zaplecza magazynu.
controlQueueBatchSize	32	Liczba komunikatów do ściągnięcia z kolejki sterowania jednocześnie.
controlQueueBufferThreshold	Plan zużycia dla języka Python: 32 Plan zużycia dla języków JavaScript i C#: 128 Plan dedykowany/Premium: 256	Liczba komunikatów kolejki sterowania, które mogą być buforowane w pamięci w danym momencie, w tym momencie dyspozytor będzie czekać przed usunięciem z kolejki wszelkich dodatkowych komunikatów.
partitionCount	4	Liczba partycji dla kolejki sterowania. Może być dodatnią liczbą całkowitą z zakresu od 1 do 16.
controlQueueVisibilityTimeout	5 min	Limit czasu widoczności komunikatów kolejki w kolejce.
workItemQueueVisibilityTimeout	5 min	Limit czasu widoczności komunikatów kolejki elementów roboczych w kolejce w kolejce.
maxConcurrentActivityFunctions	Plan zużycia: 10 Plan dedykowany/Premium: 10X liczba procesorów na bieżącej maszynie	Maksymalna liczba funkcji działań, które mogą być przetwarzane współbieżnie w jednym wystąpieniu hosta.
maxConcurrentOrchestratorFunctions	Plan zużycia: 5 Plan dedykowany/Premium: 10X liczba procesorów na bieżącej maszynie	Maksymalna liczba funkcji orkiestratora, które mogą być przetwarzane współbieżnie w jednym wystąpieniu hosta.
maxQueuePollingInterval	30 sekund	Maksymalny interwał sondowania kolejki kontrolek i elementów roboczych w formacie hh:mm:ss . Wyższe wartości mogą spowodować większe opóźnienia przetwarzania komunikatów. Niższe wartości mogą spowodować wyższe koszty magazynowania z powodu zwiększonych transakcji magazynu.
connectionName (2.7.0 i nowsze) connectionStringName (2.x) azureStorage Połączenie ionStringName (1.x)	AzureWebJobsStorage	Nazwa ustawienia aplikacji lub kolekcji ustawień, która określa sposób nawiązywania połączenia z bazowymi zasobami usługi Azure Storage. Po podaniu pojedynczego ustawienia aplikacji powinno to być parametry połączenia usługi Azure Storage.
trackingStore Połączenie ionName (2.7.0 i nowsze) trackingStore Połączenie ionStringName		Nazwa ustawienia aplikacji lub kolekcji ustawień, która określa sposób nawiązywania połączenia z tabelami Historia i wystąpienia. Po podaniu pojedynczego ustawienia aplikacji powinno to być parametry połączenia usługi Azure Storage. Jeśli nie zostanie określony, `connectionStringName` zostanie użyte połączenie (Durable 2.x) lub `azureStorageConnectionStringName` (Durable 1.x).
trackingStoreNamePrefix		Prefiks używany dla tabel Historia i Wystąpienia, gdy `trackingStoreConnectionStringName` jest określony. Jeśli nie zostanie ustawiona, domyślną wartością prefiksu będzie `DurableTask`. Jeśli `trackingStoreConnectionStringName` nie zostanie określony, tabele Historia i wystąpienia będą używać wartości jako prefiksu `hubName` , a każde ustawienie dla `trackingStoreNamePrefix` elementu zostanie zignorowane.
traceInputsAndOutputs	fałsz	Wartość wskazująca, czy śledzić dane wejściowe i wyjściowe wywołań funkcji. Zachowaniem domyślnym podczas śledzenia zdarzeń wykonywania funkcji jest uwzględnienie liczby bajtów w serializowanych danych wejściowych i wyjściowych dla wywołań funkcji. To zachowanie zapewnia minimalne informacje o tym, jak wyglądają dane wejściowe i wyjściowe bez wzdęcia dzienników lub przypadkowo uwidaczniania poufnych informacji. Ustawienie tej właściwości na true powoduje, że domyślne rejestrowanie funkcji w celu rejestrowania całej zawartości danych wejściowych i wyjściowych funkcji.
traceReplayEvents	fałsz	Wartość wskazująca, czy zapisywać zdarzenia replay orkiestracji do aplikacji Szczegółowe informacje.
eventGridTopicEndpoint		Adres URL niestandardowego punktu końcowego tematu usługi Azure Event Grid. Po ustawieniu tej właściwości zdarzenia powiadomień cyklu życia orkiestracji są publikowane w tym punkcie końcowym. Ta właściwość obsługuje rozpoznawanie Ustawienia aplikacji.
eventGridKeySettingName		Nazwa ustawienia aplikacji zawierającego klucz używany do uwierzytelniania za pomocą tematu niestandardowego usługi Azure Event Grid pod adresem `EventGridTopicEndpoint`.
eventGridPublishRetryCount	0	Liczba ponownych prób w przypadku niepowodzenia publikowania w temacie usługi Event Grid.
eventGridPublishRetryInterval	5 min	Usługa Event Grid publikuje interwał ponawiania prób w formacie hh:mm:ss .
eventGridPublishEventTypes		Lista typów zdarzeń do opublikowania w usłudze Event Grid. Jeśli nie zostanie określony, wszystkie typy zdarzeń zostaną opublikowane. Dozwolone wartości to `Started`, , `FailedCompleted`, `Terminated`.
useAppLease	true	Po ustawieniu wartości `true`aplikacje będą wymagać uzyskania dzierżawy obiektów blob na poziomie aplikacji przed przetworzeniem komunikatów centrum zadań. Aby uzyskać więcej informacji, zobacz dokumentację odzyskiwania po awarii i dystrybucji geograficznej. Dostępne od wersji 2.3.0.
useLegacyPartitionManagement	fałsz	W przypadku ustawienia na `false`wartość program używa algorytmu zarządzania partycjami, który zmniejsza możliwość zduplikowania wykonywania funkcji podczas skalowania w górę. Dostępne od wersji 2.3.0.
useTablePartitionManagement	fałsz	W przypadku ustawienia na `true`wartość użyje algorytmu zarządzania partycjami zaprojektowanego w celu zmniejszenia kosztów kont usługi Azure Storage w wersji 2. Dostępne od wersji 2.10.0. Ta funkcja jest obecnie w wersji zapoznawczej i nie jest jeszcze zgodna z planem Zużycie.
useGracefulShutdown	fałsz	(Wersja zapoznawcza) Włącz bezproblemowe zamykanie, aby zmniejszyć prawdopodobieństwo zamknięcia hosta zakończonych niepowodzeniem wykonywania funkcji w procesie.
maxEntityOperationBatchSize(2.6.1)	Plan zużycia: 50 Plan dedykowany/Premium: 5000	Maksymalna liczba operacji jednostki przetwarzanych jako partia. Jeśli ustawiono wartość 1, przetwarzanie wsadowe jest wyłączone, a każdy komunikat operacji jest przetwarzany przez osobne wywołanie funkcji.
storeInputsInOrchestrationHistory	fałsz	Gdy jest ustawiona wartość `true`, informuje rozszerzenie Durable Task Framework o zapisaniu danych wejściowych działań w tabeli historii. Umożliwia to wyświetlanie danych wejściowych funkcji działania podczas wykonywania zapytań dotyczących historii aranżacji.

Wiele z tych ustawień jest przeznaczonych do optymalizacji wydajności. Aby uzyskać więcej informacji, zobacz Wydajność i skala.

eventHub

Ustawienia konfiguracji wyzwalaczy i powiązań centrum zdarzeń.

— funkcje

Lista funkcji uruchamianych przez hosta zadań. Pusta tablica oznacza uruchamianie wszystkich funkcji. Przeznaczone do użytku tylko w przypadku uruchamiania lokalnego. W aplikacjach funkcji na platformie Azure należy zamiast tego wykonać kroki opisane w temacie Jak wyłączyć funkcje w usłudze Azure Functions , aby wyłączyć określone funkcje, a nie używać tego ustawienia.

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

functionTimeout

Wskazuje czas trwania limitu czasu dla wszystkich funkcji. W planie użycia bezserwerowego prawidłowy zakres wynosi od 1 sekundy do 10 minut, a wartość domyślna to 5 minut. W planie usługi App Service nie ma ogólnego limitu, a wartość domyślna ma wartość null, co oznacza brak limitu czasu.

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

healthMonitor

Ustawienia konfiguracji monitora kondycji hosta.

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

Właściwości	Domyślny	opis
enabled	true	Określa, czy funkcja jest włączona.
healthCheckInterval	10 sekund	Przedział czasu między okresowymi kontrolami kondycji w tle.
healthCheckWindow	2 minuty	Przesuwane okno czasowe używane z ustawieniem `healthCheckThreshold` .
healthCheckThreshold	6	Maksymalna liczba przypadków niepowodzenia sprawdzania kondycji przed zainicjowaniem recyklingu hosta.
counterThreshold	0.80	Próg, przy którym licznik wydajności zostanie uznany za w złej kondycji.

http

Ustawienia konfiguracji wyzwalaczy i powiązań http.

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

Właściwości	Domyślny	opis
dynamicThrottlesEnabled	fałsz	Po włączeniu tego ustawienia to ustawienie powoduje, że potok przetwarzania żądań okresowo sprawdza liczniki wydajności systemu, takie jak połączenia/wątki/procesy/pamięć/procesor/itp., a jeśli którykolwiek z tych liczników przekracza wbudowany wysoki próg (80%), żądania są odrzucane z odpowiedzią 429 "Zbyt zajęta", dopóki liczniki nie powrócą do normalnych poziomów.
maxConcurrentRequests	bez ruchu przychodzącego (`-1`)	Maksymalna liczba funkcji HTTP, które będą wykonywane równolegle. Pozwala to kontrolować współbieżność, co może pomóc w zarządzaniu wykorzystaniem zasobów. Na przykład może istnieć funkcja HTTP, która używa dużej ilości zasobów systemowych (pamięci/procesora/gniazd), tak aby powodowała problemy, gdy współbieżność jest zbyt wysoka. Możesz też mieć funkcję, która wysyła żądania wychodzące do usługi innej firmy, a te wywołania muszą być ograniczone. W takich przypadkach może pomóc zastosowanie ograniczania przepustowości.
maxOutstandingRequests	bez ruchu przychodzącego (`-1`)	Maksymalna liczba zaległych żądań, które są przechowywane w danym momencie. Ten limit obejmuje żądania, które są kolejkowane, ale nie zostały uruchomione, oraz wszelkie wykonania w toku. Wszystkie żądania przychodzące powyżej tego limitu są odrzucane z odpowiedzią 429 "Zbyt zajęta". Dzięki temu osoby wywołujące mogą używać strategii ponawiania prób opartych na czasie, a także pomaga kontrolować maksymalne opóźnienia żądań. Spowoduje to tylko kolejkowanie, które występuje w ścieżce wykonywania hosta skryptu. Inne kolejki, takie jak kolejka żądań ASP.NET, będą nadal obowiązywać i nie będą podlegać temu ustawieniu.
routePrefix	api	Prefiks trasy, który ma zastosowanie do wszystkich tras. Użyj pustego ciągu, aby usunąć prefiks domyślny.

identyfikator

Unikatowy identyfikator hosta zadań. Może być małym identyfikatorem GUID z usuniętymi kreskami. Wymagane w przypadku uruchamiania lokalnego. Podczas uruchamiania na platformie Azure zalecamy, aby nie ustawiać wartości identyfikatora. Identyfikator jest generowany automatycznie na platformie Azure, gdy id zostanie pominięty.

Jeśli udostępniasz konto usługi Storage w wielu aplikacjach funkcji, upewnij się, że każda aplikacja funkcji ma inny idelement . Właściwość można pominąć id lub ręcznie ustawić dla każdej aplikacji id funkcji inną wartość. Wyzwalacz czasomierza używa blokady magazynu, aby upewnić się, że wystąpi tylko jedno wystąpienie czasomierza, gdy aplikacja funkcji skaluje w poziomie do wielu wystąpień. Jeśli dwie aplikacje funkcji współdzielą tę samą id funkcję, a każda z nich używa wyzwalacza czasomierza, uruchamia tylko jeden czasomierz.

{
    "id": "9f4ea53c5136457d883d685e57164f08"
}

Rejestratora

Steruje filtrowaniem dzienników napisanych przez obiekt ILogger lub context.log.

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

Właściwości	Domyślny	opis
categoryFilter	nie dotyczy	Określa filtrowanie według kategorii
defaultLevel	Informacja	W przypadku wszystkich kategorii, które nie zostały określone w tablicy`categoryLevels`, wyślij dzienniki na tym poziomie i powyżej do aplikacji Szczegółowe informacje.
categoryLevels	nie dotyczy	Tablica kategorii, która określa minimalny poziom dziennika, który ma być wysyłany do aplikacji Szczegółowe informacje dla każdej kategorii. Kategoria określona tutaj steruje wszystkimi kategoriami, które zaczynają się od tej samej wartości, a dłuższe wartości mają pierwszeństwo. W poprzednim przykładowym pliku host.json wszystkie kategorie rozpoczynające się od dziennika "Host.Aggregator" na `Information` poziomie. Wszystkie inne kategorie rozpoczynające się od "Host", takie jak "Host.Executor", rejestrują się na `Error` poziomie.

kolejki

Ustawienia konfiguracji wyzwalaczy i powiązań kolejki usługi Storage.

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

Właściwości	Domyślny	opis
maxPollingInterval	60000	Maksymalny interwał w milisekundach między sondami kolejki.
visibilityTimeout (limit czasu widoczności)	0	Interwał czasu między ponowną próbą w przypadku niepowodzenia przetwarzania komunikatu.
batchSize	16	Liczba komunikatów kolejki pobieranych jednocześnie przez środowisko uruchomieniowe usługi Functions i przetwarza je równolegle. Gdy przetwarzany numer jest w dół do `newBatchThreshold`, środowisko uruchomieniowe pobiera kolejną partię i rozpoczyna przetwarzanie tych komunikatów. Dlatego maksymalna liczba przetwarzanych współbieżnych komunikatów na funkcję to `batchSize` plus `newBatchThreshold`. Ten limit ma zastosowanie oddzielnie do każdej funkcji wyzwalanej przez kolejkę. Jeśli chcesz uniknąć równoległego wykonywania komunikatów odebranych w jednej kolejce, możesz ustawić wartość `batchSize` 1. Jednak to ustawienie eliminuje współbieżność tylko tak długo, jak aplikacja funkcji działa na jednej maszynie wirtualnej. Jeśli aplikacja funkcji skaluje się w poziomie do wielu maszyn wirtualnych, każda maszyna wirtualna może uruchomić jedno wystąpienie każdej funkcji wyzwalanej w kolejce. Maksymalna wartość `batchSize` to 32.
maxDequeueCount	5	Liczba prób przetworzenia komunikatu przed przeniesieniem go do kolejki trucizny.
newBatchThreshold	batchSize/2	Za każdym razem, gdy liczba przetwarzanych jednocześnie komunikatów spadnie do tej liczby, środowisko uruchomieniowe pobiera kolejną partię.

SendGrid

Ustawienie konfiguracji powiązania wyjściowego SendGrind

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

Właściwości	Domyślny	opis
from	nie dotyczy	Adres e-mail nadawcy we wszystkich funkcjach.

serviceBus

Ustawienie konfiguracji wyzwalaczy i powiązań usługi Service Bus.

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

Właściwości	Domyślny	opis
Maxconcurrentcalls	16	Maksymalna liczba współbieżnych wywołań wywołań zwrotnych, które powinna zainicjować pompa komunikatu. Domyślnie środowisko uruchomieniowe usługi Functions przetwarza wiele komunikatów jednocześnie. Aby skierować środowisko uruchomieniowe do przetwarzania tylko pojedynczej kolejki lub komunikatu tematu w danym momencie, ustaw wartość `maxConcurrentCalls` 1.
prefetchCount	nie dotyczy	Domyślny prefetchCount, który będzie używany przez podstawowy element ServiceBusReceiver.
autoRenewTimeout	00:05:00	Maksymalny czas trwania, w którym blokada komunikatu zostanie odnowiona automatycznie.
autoComplete	true	Gdy wartość true, wyzwalacz automatycznie ukończy przetwarzanie komunikatów po pomyślnym wykonaniu operacji. W przypadku wartości false jest to odpowiedzialność funkcji za ukończenie komunikatu przed zwróceniem.

Singleton

Ustawienia konfiguracji zachowania pojedynczej blokady. Aby uzyskać więcej informacji, zobacz Problem z usługą GitHub dotyczący obsługi pojedynczej wersji.

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

Właściwości	Domyślny	opis
lockPeriod	00:00:15	Okres, dla którego są pobierane blokady poziomu funkcji. Blokady są automatycznie odnawiane.
listenerLockPeriod	00:01:00	Okres, dla którego są pobierane blokady odbiornika.
listenerLockRecoveryPollingInterval	00:01:00	Interwał czasu używany do odzyskiwania blokady odbiornika, jeśli nie można uzyskać blokady odbiornika podczas uruchamiania.
lockAcquisitionTimeout	00:01:00	Maksymalny czas próby uzyskania blokady przez środowisko uruchomieniowe.
lockAcquisitionPollingInterval	nie dotyczy	Interwał między próbami uzyskania blokady.

Śledzenia

Wersja 1.x

Ustawienia konfiguracji dzienników tworzonych przy użyciu TraceWriter obiektu. Aby dowiedzieć się więcej, zobacz [Rejestrowanie w języku C#].

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

Właściwości	Domyślny	opis
consoleLevel	informacje o	Poziom śledzenia na potrzeby rejestrowania konsoli. Opcje to: `off`, , `warningerror`, `info`, i `verbose`.
fileLoggingMode	debugonly	Poziom śledzenia rejestrowania plików. Opcje to `never`, , `debugOnlyalways`.

watchDirectories

Zestaw udostępnionych katalogów kodu, które powinny być monitorowane pod kątem zmian. Gwarantuje, że po zmianie kodu w tych katalogach zmiany są pobierane przez funkcje.

{
    "watchDirectories": [ "Shared" ]
}

Następne kroki

Dowiedz się, jak zaktualizować plik host.json

Utrwalanie ustawień w zmiennych środowiskowych