Skip to content

Commit 5efa89d

Browse files
committed
edit pass: functions-recover-storage-account
1 parent e709cd0 commit 5efa89d

File tree

1 file changed

+45
-47
lines changed

1 file changed

+45
-47
lines changed
Lines changed: 45 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: How to troubleshoot Azure Functions Runtime is unreachable.
2+
title: 'Troubleshoot error: Azure Functions Runtime is unreachable'
33
description: Learn how to troubleshoot an invalid storage account.
44
author: alexkarcher-msft
55

@@ -8,94 +8,92 @@ ms.date: 09/05/2018
88
ms.author: alkarche
99
---
1010

11-
# How to troubleshoot "functions runtime is unreachable"
11+
# Troubleshoot error: "Azure Functions Runtime is unreachable"
1212

13+
This article is intended to help you troubleshoot the following error if it's displayed in the Azure Functions portal:
1314

14-
## Error text
15-
This article is intended to troubleshoot the following error when displayed in the Functions portal.
15+
> "Error: Azure Functions Runtime is unreachable. Click here for details on storage configuration."
1616
17-
`Error: Azure Functions Runtime is unreachable. Click here for details on storage configuration`
17+
This issue occurs when the Azure Functions Runtime can't start. The most common reason for the issue is that the function app has lost access to its storage account. For more information, see [Storage account requirements](https://docs.microsoft.com/azure/azure-functions/functions-create-function-app-portal#storage-account-requirements).
1818

19-
### Summary
20-
This issue occurs when the Azure Functions Runtime cannot start. The most common reason for this error to occur is the function app losing access to its storage account. [Read more about the storage account requirements here](https://docs.microsoft.com/azure/azure-functions/functions-create-function-app-portal#storage-account-requirements)
19+
This article walks you through the six most common error cases and shows you how to identify and resolve each case.
2120

22-
### Troubleshooting
23-
We'll walk through the four most common error cases, how to identify, and how to resolve each case.
24-
25-
1. Storage Account deleted
26-
1. Storage Account application settings deleted
27-
1. Storage Account credentials invalid
28-
1. Storage Account Inaccessible
29-
1. Daily Execution Quota Full
30-
1. App is behind a firewall
21+
* Storage account deleted
22+
* Storage account application settings deleted
23+
* Storage account credentials invalid
24+
* Storage account inaccessible
25+
* Daily execution quota full
26+
* App is behind a firewall
3127

3228

3329
## Storage account deleted
3430

35-
Every function app requires a storage account to operate. If that account is deleted your Function will not work.
36-
37-
### How to find your storage account
31+
Every function app requires a storage account to operate. If that account is deleted, your function won't work.
3832

39-
Start by looking up your storage account name in your Application Settings. Either `AzureWebJobsStorage` or `WEBSITE_CONTENTAZUREFILECONNECTIONSTRING` will contain the name of your storage account wrapped up in a connection string. Read more specifics at the [application setting reference here](https://docs.microsoft.com/azure/azure-functions/functions-app-settings#azurewebjobsstorage).
33+
Start by looking up your storage account name in your application settings. Either `AzureWebJobsStorage` or `WEBSITE_CONTENTAZUREFILECONNECTIONSTRING` contains the name of your storage account wrapped up in a connection string. For more information, see [App settings reference for Azure Functions](https://docs.microsoft.com/azure/azure-functions/functions-app-settings#azurewebjobsstorage).
4034

41-
Search for your storage account in the Azure portal to see if it still exists. If it has been deleted, you will need to recreate a storage account and replace your storage connection strings. Your function code is lost and you will need to redeploy it again.
35+
Search for your storage account in the Azure portal to see whether it still exists. If it has been deleted, re-create the storage account and replace your storage connection strings. Your function code is lost, and you need to redeploy it.
4236

4337
## Storage account application settings deleted
4438

45-
In the previous step, if you did not have a storage account connection string it was likely deleted or overwritten. Deleting app settings is most commonly done when using deployment slots or Azure Resource Manager scripts to set application settings.
39+
In the preceding step, if you can't find a storage account connection string, it was likely deleted or overwritten. Deleting application settings most commonly happens when you're using deployment slots or Azure Resource Manager scripts to set application settings.
4640

4741
### Required application settings
4842

49-
* Required
43+
* Required:
5044
* [`AzureWebJobsStorage`](https://docs.microsoft.com/azure/azure-functions/functions-app-settings#azurewebjobsstorage)
51-
* Required for Consumption Plan Functions
45+
* Required for consumption plan functions:
5246
* [`WEBSITE_CONTENTAZUREFILECONNECTIONSTRING`](https://docs.microsoft.com/azure/azure-functions/functions-app-settings)
5347
* [`WEBSITE_CONTENTSHARE`](https://docs.microsoft.com/azure/azure-functions/functions-app-settings)
5448

55-
[Read about these application settings here](https://docs.microsoft.com/azure/azure-functions/functions-app-settings).
49+
For more information, see [App settings reference for Azure Functions](https://docs.microsoft.com/azure/azure-functions/functions-app-settings).
5650

5751
### Guidance
5852

59-
* Do not check "slot setting" for any of these settings. When you swap deployment slots the Function will break.
60-
* Do not modify these settings as part of automated deployments.
61-
* These settings must be provided and valid at creation time. An automated deployment that does not contain these settings will result in a non-functional App, even if the settings are added after the fact.
53+
* Don't select **slot setting** for any of these settings. When you swap deployment slots, the function will break.
54+
* Don't modify these settings as part of automated deployments.
55+
* These settings must be provided and valid at creation time. An automated deployment that doesn't contain these settings will result in a non-functional app, even if the settings are added after the fact.
6256

6357
## Storage account credentials invalid
6458

65-
The above Storage Account connection strings must be updated if you regenerate storage keys. [Read more about storage key management here](https://docs.microsoft.com/azure/storage/common/storage-create-storage-account).
59+
The previously discussed storage account connection strings must be updated if you regenerate storage keys. For more information about storage key management, see [Create an Azure Storage account](https://docs.microsoft.com/azure/storage/common/storage-create-storage-account).
6660

6761
## Storage account inaccessible
6862

69-
Your Function App must be able to access the storage account. Common issues that block a Functions access to a storage account are:
63+
Your function app must be able to access the storage account. Common issues that block a function app's access to a storage account are:
7064

71-
* Function Apps deployed to App Service Environments without the correct network rules to allow traffic to and from the storage account
72-
* The storage account firewall is enabled and not configured to allow traffic to and from Functions. [Read more about storage account firewall configuration here](https://docs.microsoft.com/azure/storage/common/storage-network-security?toc=%2fazure%2fstorage%2ffiles%2ftoc.json)
65+
* The function app is deployed to an App Service environment without the correct network rules to allow traffic to and from the storage account.
66+
* The storage account firewall is enabled and not configured to allow traffic to and from functions. For more information, see [Configure Azure Storage firewalls and virtual networks](https://docs.microsoft.com/azure/storage/common/storage-network-security?toc=%2fazure%2fstorage%2ffiles%2ftoc.json).
7367

74-
## Daily Execution Quota Full
68+
## Daily execution quota full
7569

76-
If you have a Daily Execution Quota configured, your Function App will be temporarily disabled and many of the portal controls will become unavailable.
70+
If you have a daily execution quota configured, your function app is temporarily disabled, and many of the portal controls are unavailable.
7771

78-
* To verify, open Platform Features > Function App Settings in the portal. You will see the following message if you are over quota:
79-
* `The Function App has reached daily usage quota and has been stopped until the next 24 hours time frame.`
80-
* Remove the quota and restart your app to resolve the issue.
72+
* To verify the quota, go to **Platform Features** > **Function App Settings** in the portal. If you're over quota, the following message is displayed:
73+
> "The Function App has reached daily usage quota and has been stopped until the next 24 hours time frame."
74+
* To resolve the issue, remove the quota and restart your app.
8175

8276
## App is behind a firewall
8377

84-
Your function runtime will be unreachable if your function app is hosted in an [internally load balanced App Service Environment](../app-service/environment/create-ilb-ase.md) and is configured to block inbound internet traffic, or has [inbound IP restrictions](functions-networking-options.md#inbound-ip-restrictions) configured to block internet access. The Azure portal makes calls directly to the running app to fetch the list of functions and also makes HTTP calls to KUDU endpoint. Platform level settings under the `Platform Features` tab will still be available.
78+
Your function runtime is unreachable if your function app is hosted in an [internally load balanced App Service Environment](../app-service/environment/create-ilb-ase.md) and it's configured to block inbound internet traffic, or if it has [inbound IP restrictions](functions-networking-options.md#inbound-ip-restrictions) that are configured to block internet access. The Azure portal makes calls directly to the running app to fetch the list of functions, and it makes HTTP calls to the Kudu endpoint. Platform level settings under the **Platform Features** tab are still available.
8579

86-
* To verify your ASE configuration, navigate to the NSG of the subnet where ASE resides and validate inbound rules to allow traffic coming from the public IP of the computer where you are accessing the application. You can also use the portal from a computer connected to the virtual network running your app or a virtual machine running in your virtual network. [Read more about inbound rule configuration here](https://docs.microsoft.com/azure/app-service/environment/network-info#network-security-groups)
80+
* To verify your App Service Environment (ASE) configuration:
81+
1. Go to the network security group (NSG) of the subnet where ASE resides.
82+
1. Validate the inbound rules to allow traffic coming from the public IP of the computer where you are accessing the application.
83+
84+
You can also use the portal from a computer connected to the virtual network that's running your app or a virtual machine that's running in your virtual network. For more information about inbound rule configuration, see [Networking considerations for an App Service Environment](https://docs.microsoft.com/azure/app-service/environment/network-info#network-security-groups).
8785

88-
## Next Steps
86+
## Next steps
8987

90-
Now that your Function App is back and operational take a look at our quickstarts and developer references to get up and running again!
88+
Now that your function app is back and operational, take a look at our quickstarts and developer references:
9189

92-
* [Create your first Azure Function](functions-create-first-azure-function.md)
93-
Jump right in and create your first function using the Azure Functions quickstart.
90+
* [Create your first Azure function](functions-create-first-azure-function.md)
91+
Jump right in and create your first function by using the Azure function's quickstart.
9492
* [Azure Functions developer reference](functions-reference.md)
95-
Provides more technical information about the Azure Functions runtime and a reference for coding functions and defining triggers and bindings.
96-
* [Testing Azure Functions](functions-test-a-function.md)
93+
Provides more technical information about the Azure Functions Runtime and a reference for coding functions and defining triggers and bindings.
94+
* [Testing Azure functions](functions-test-a-function.md)
9795
Describes various tools and techniques for testing your functions.
98-
* [How to scale Azure Functions](functions-scale.md)
96+
* [How to scale Azure functions](functions-scale.md)
9997
Discusses service plans available with Azure Functions, including the Consumption hosting plan, and how to choose the right plan.
10098
* [Learn more about Azure App Service](../app-service/overview.md)
101-
Azure Functions leverages Azure App Service for core functionality like deployments, environment variables, and diagnostics.
99+
Azure Functions leverages Azure App Service for core functionality, such as deployments, environment variables, and diagnostics.

0 commit comments

Comments
 (0)