Merge pull request #210117 from soninaren/diagnosticEvents

Adding diagnostic events documentation

Author: Maggiemouse1

articles/azure-functions/TOC.yml

@@ -750,6 +750,14 @@
             href: errors-diagnostics/sdk-rules/azf0001.md
           - name: AZF0002
             href: errors-diagnostics/sdk-rules/azf0002.md
+        - name: Diagnostic events
+          items:
+          - name: AZFD0001
+            href: errors-diagnostics/diagnostic-events/azfd0001.md
+          - name: AZFD0002
+            href: errors-diagnostics/diagnostic-events/azfd0002.md
+          - name: AZFD0003
+            href: errors-diagnostics/diagnostic-events/azfd0003.md
     - name: host.json 2.x reference
       href: functions-host-json.md
     - name: host.json 1.x reference

articles/azure-functions/errors-diagnostics/diagnostic-events/azfd0001.md

@@ -0,0 +1,32 @@
+---
+title: "AZFD0001: AzureWebJobsStorage app setting is not present."
+titleSuffix: "Azure Functions"
+description: "AZFD0001: AzureWebJobsStorage app setting is not present"
+author: soninaren
+ms.author: nasoni
+ms.topic: troubleshooting
+ms.date: 09/03/2022
+---
+
+# AZFD0001: AzureWebJobsStorage app setting is not present.
+
+This event occurs when the function app doesn't have the `AzureWebJobsStorage` app setting configured for the function app.
+
+| | Value |
+|-|-|
+| **Event ID** |AZFD0001|
+| **Category** |[Usage]|
+| **Severity** |Error|
+
+## Event description
+The `AzureWebJobsStorage` app setting is used to store the connection string of the Azure Storage account associated with the function app. The Azure Functions runtime uses this connection for core behaviors such as coordinating singleton execution of timer triggers, default app key storage, and storing diagnostic events.
+
+For more information, see [AzureWebJobsStorage](../../functions-app-settings.md#azurewebjobsstorage).
+
+## How to resolve the event
+
+Create a new app setting on your function app with name `AzureWebJobsStorage` with a valid storage account connection string as the value. For more information, see [Work with application settings](../../functions-how-to-use-azure-function-app-settings.md#settings).
+
+## When to suppress the event
+
+This event shouldn't be suppressed.

articles/azure-functions/errors-diagnostics/diagnostic-events/azfd0002.md

@@ -0,0 +1,30 @@
+---
+title: "AZFD0002: Value of AzureWebJobsStorage app setting is invalid."
+titleSuffix: "Azure Functions"
+description: "AZFD0002: Value of AzureWebJobsStorage app setting is invalid."
+author: soninaren
+ms.author: nasoni
+ms.topic: troubleshooting
+ms.date: 09/03/2022
+---
+
+# AZFD0002: Value of AzureWebJobsStorage app setting is invalid.
+
+This event occurs when the value of the `AzureWebJobsStorage` app setting is set to either an invalid Azure Storage account connection string or to a Key Vault reference.
+
+| | Value |
+|-|-|
+| **Event ID** |AZFD0002|
+| **Category** |[Usage]|
+| **Severity** |Error|
+
+## Event description
+The `AzureWebJobsStorage` app setting is used to store the connection string of the storage account associated with the function app. The Azure Functions runtime uses this connection for core behaviors such as coordinating singleton execution of timer triggers, default app key storage, and storing diagnostic events. This app setting needs to be set to a valid connection string.
+
+For more information, see [AzureWebJobsStorage](../../functions-app-settings.md#azurewebjobsstorage).
+
+## How to resolve the event
+Update the value of the `AzureWebJobsStorage` app setting on your function app with a valid storage account connection string.
+
+## When to suppress the event
+You should suppress this event when your function app uses an Azure Key Vault reference in the `AzureWebjobsStorage` app setting instead of a connection string. For more information, see [Source application settings from Key Vault](../../../app-service/app-service-key-vault-references.md?toc=%2Fazure%2Fazure-functions%2Ftoc.json#source-application-settings-from-key-vault)

articles/azure-functions/errors-diagnostics/diagnostic-events/azfd0003.md

@@ -0,0 +1,32 @@
+---
+title: "AZFD0003: Encountered a StorageException while trying to fetch the diagnostic events."
+titleSuffix: "Azure Functions"
+description: "AZFD0003: Encountered a StorageException while trying to fetch the diagnostic events."
+author: soninaren
+ms.author: nasoni
+ms.topic: troubleshooting
+ms.date: 09/03/2022
+---
+
+# AZFD0003: Encountered a StorageException while trying to fetch the diagnostic events.
+
+This event occurs when the Azure Storage account connection string value in the `AzureWebJobsStorage` app setting either doesn't have permissions to access Azure Table Storage or generates exceptions when trying to connect to storage.
+
+| | Value |
+|-|-|
+| **Event ID** |AZFD0003|
+| **Category** |[Usage]|
+| **Severity** |Error|
+
+## Event description
+The `AzureWebJobsStorage` app setting is used to store the connection string of the storage account associated with the function app. The Azure Functions runtime uses this connection for core behaviors such as coordinating singleton execution of timer triggers, default app key storage, and storing diagnostic events. 
+
+The connection string set in `AzureWebJobsStorage` must be for an account that has permissions to store and read diagnostic events from Table Storage. The complete set of read, write, delete, add, and create events must be supported.
+
+For more information, see [AzureWebJobsStorage](../../functions-app-settings.md#azurewebjobsstorage).
+
+## How to resolve the event
+Make sure that the storage account for the connection string stored in `AzureWebJobsStorage` has permissions to read, write, delete, add and create in Table Storage. Clients should be able to access Storage using this connection string without generating exceptions.
+
+## When to suppress the event
+This event should not be suppressed.