How to implement or add health checks for an Azure Function App running in a Container Apps environment, where the Function App is not polling a health API

Question

How to implement or add health checks for an Azure Function App running in a Container Apps environment, where the Function App is not polling a health API

Jubair Ahmad 20

I am using the Microsoft.Web/sites@2022-09-01 resource type to deploy a Function App within a Container Apps environment, created via the azapi_resource in Terraform. I’ve configured the health check with healthCheckPath = "string", but I am unable to find the 'Health Check' option in the Azure portal for this Function App. Despite including health check settings in my Terraform code and attempting to enable it directly from the portal, the health check option does not appear on the Function App's overview page within the Container Apps environment. Additionally, the Function App is not polling the health check as expected when the healthCheckPath is provided.

Below is the overview page of function App inside container Apps env. we can not find healthcheck here.
User's image

And below is the image where we have functionapp based on appservice plan. Here we can see the healthcheck
User's image

Sai Prabhu Naveen Parimi 2,260 Reputation points Microsoft External Staff Moderator

2025-04-09T07:26:13.0233333+00:00
@Ahmad, Jubair

Thanks for reaching out, to clarify how health checks work for Function Apps hosted within Azure Container Apps, as they differ from the traditional setup using App Service Plans.

In Azure Container Apps, health checks are not managed through the healthCheckPath setting like they are for Web Apps or Function Apps hosted on App Service Plans. So, if you're using the Microsoft.Web/sites@2022-09-01 resource type and deploying your Function App into a Container Apps environment, the Health Check option will not appear in the Azure portal for that Function App — and that's expected behavior.

Instead, Azure Container Apps use container-level health probes, which are configured using HTTP(S) or TCP checks. These probes help the platform monitor the health of your app and restart containers if necessary.

To enable health checks in this environment:

Expose a valid health endpoint in your Function App (e.g., /api/health).

Configure liveness or readiness probes to target this endpoint when defining your Container App.

Make sure the endpoint is responsive and correctly implemented.

If the health probe fails or doesn’t behave as expected, double-check:

That the probe path matches the one exposed by your app.

That the app is fully initialized and ready when the probe is executed.

You can also use diagnostic tools available in Azure Container Apps to investigate further if health probe failures persist.

Helpful References:

troubleshoot-health-probe-failures

Health probes in Azure Container Apps

I hope this helps. Feel free to ask if you have any queries.
Jubair Ahmad 20 Reputation points

2025-04-09T07:38:00.2233333+00:00

Hi @Sai Prabhu Naveen Parimi Thankyou for your response,
when we are creating function within a container app environment we are not providing any config to create container app , Function app itself creating a container app and we are not able to modify any config of that container app because it has Deny assignment role.

do we need to provide container app configuration as well when creating function app?
Sai Prabhu Naveen Parimi 2,260 Reputation points Microsoft External Staff Moderator

2025-04-09T10:12:40.46+00:00
@Ahmad, Jubair

Thanks for sharing the screenshot.

When you create a Function App in a Container Apps environment without explicitly creating the container app yourself, Azure automatically provisions and manages that environment behind the scenes. This is why you're seeing a Deny assignment on the container app resource — it's by design to prevent changes to system-managed infrastructure.

Reference:https://learn.microsoft.com/en-us/azure/role-based-access-control/deny-assignments?tabs=azure-portal

Because of that, you won’t be able to modify things like health probes or other container app-level settings.

Do you need to provide Container App configuration?

If you're using the default setup where Azure handles the Container App environment automatically, then: → No, you cannot provide or modify container app configuration manually.

If your use case requires advanced configuration (e.g., custom health probes, scaling rules, networking, or observability settings), then: → Yes, you should create the Azure Container App and its environment explicitly and deploy your Function App (as a container) into that environment.

https://learn.microsoft.com/en-us/azure/azure-functions/functions-deploy-container?tabs=acr%2Cbash%2Cazure-cli&pivots=programming-language-csharp

Please feel free to ask if you have any questions.
Jubair Ahmad 20 Reputation points

2025-04-09T10:56:41.42+00:00

@Sai Prabhu Naveen Parimi
Our goal is to create function App within a container app environment with Consumption plan where function app continuously polling health check.
The document provided by you is just creating containerized Azure Functions with premium service plan.
Pravallika Kothaveeranna Gari 955 Reputation points Microsoft External Staff Moderator

2025-04-14T12:57:49.58+00:00
Ahmad, Jubair, Refer MSDOC or follow below steps to implement health checks for an Azure Function App running in a Container Apps environment

Define Built-In Health Probes:

Liveness Probe: This is to checks if the container is running. If the probe fails, the container is restarted.

Readiness Probe: This is to check if your container is ready to serve traffic. If the probe fails, the container is removed from the load balancer.

These probes can be configured in the Container Apps YAML or Terraform configuration.

livenessProbe: httpGet: path: /api/health port: 80 initialDelaySeconds: 3 periodSeconds: 10 readinessProbe: httpGet: path: /api/health port: 80 initialDelaySeconds: 3 periodSeconds: 10

Write a custom Health check function:

Create a HTTP-triggered function and implement a dedicated health-check endpoint like /api/health that checks the status of internal dependencies and return a simple status like 200 OK. Monitor it using Azure Monitor, Application Insights.
Pravallika Kothaveeranna Gari 955 Reputation points Microsoft External Staff Moderator

2025-04-15T03:45:06.34+00:00

Ahmad, Jubair, Just checking in to see if the provided answer helped. If you have any further queries, do let us know.

Accepted answer

0 additional answers

Your answer

Sai Prabhu Naveen Parimi 2,260 Reputation points Microsoft External Staff Moderator

2025-04-09T07:26:13.0233333+00:00

@Ahmad, Jubair

Thanks for reaching out, to clarify how health checks work for Function Apps hosted within Azure Container Apps, as they differ from the traditional setup using App Service Plans.

In Azure Container Apps, health checks are not managed through the healthCheckPath setting like they are for Web Apps or Function Apps hosted on App Service Plans. So, if you're using the Microsoft.Web/sites@2022-09-01 resource type and deploying your Function App into a Container Apps environment, the Health Check option will not appear in the Azure portal for that Function App — and that's expected behavior.

Instead, Azure Container Apps use container-level health probes, which are configured using HTTP(S) or TCP checks. These probes help the platform monitor the health of your app and restart containers if necessary.

To enable health checks in this environment:

Expose a valid health endpoint in your Function App (e.g., /api/health).

Configure liveness or readiness probes to target this endpoint when defining your Container App.

Make sure the endpoint is responsive and correctly implemented.

If the health probe fails or doesn’t behave as expected, double-check:

That the probe path matches the one exposed by your app.

That the app is fully initialized and ready when the probe is executed.

You can also use diagnostic tools available in Azure Container Apps to investigate further if health probe failures persist.

Helpful References:

troubleshoot-health-probe-failures

Health probes in Azure Container Apps

I hope this helps. Feel free to ask if you have any queries.
Jubair Ahmad 20 Reputation points

2025-04-09T07:38:00.2233333+00:00

Hi @Sai Prabhu Naveen Parimi Thankyou for your response,
when we are creating function within a container app environment we are not providing any config to create container app , Function app itself creating a container app and we are not able to modify any config of that container app because it has Deny assignment role.

do we need to provide container app configuration as well when creating function app?
Sai Prabhu Naveen Parimi 2,260 Reputation points Microsoft External Staff Moderator

2025-04-09T10:12:40.46+00:00

@Ahmad, Jubair

Thanks for sharing the screenshot.

When you create a Function App in a Container Apps environment without explicitly creating the container app yourself, Azure automatically provisions and manages that environment behind the scenes. This is why you're seeing a Deny assignment on the container app resource — it's by design to prevent changes to system-managed infrastructure.

Reference:https://learn.microsoft.com/en-us/azure/role-based-access-control/deny-assignments?tabs=azure-portal

Because of that, you won’t be able to modify things like health probes or other container app-level settings.

Do you need to provide Container App configuration?

If you're using the default setup where Azure handles the Container App environment automatically, then: → No, you cannot provide or modify container app configuration manually.

If your use case requires advanced configuration (e.g., custom health probes, scaling rules, networking, or observability settings), then: → Yes, you should create the Azure Container App and its environment explicitly and deploy your Function App (as a container) into that environment.

https://learn.microsoft.com/en-us/azure/azure-functions/functions-deploy-container?tabs=acr%2Cbash%2Cazure-cli&pivots=programming-language-csharp

Please feel free to ask if you have any questions.
Jubair Ahmad 20 Reputation points

2025-04-09T10:56:41.42+00:00

@Sai Prabhu Naveen Parimi
Our goal is to create function App within a container app environment with Consumption plan where function app continuously polling health check.
The document provided by you is just creating containerized Azure Functions with premium service plan.
Pravallika Kothaveeranna Gari 955 Reputation points Microsoft External Staff Moderator

2025-04-14T12:57:49.58+00:00

Ahmad, Jubair, Refer MSDOC or follow below steps to implement health checks for an Azure Function App running in a Container Apps environment

Define Built-In Health Probes:

Liveness Probe: This is to checks if the container is running. If the probe fails, the container is restarted.

Readiness Probe: This is to check if your container is ready to serve traffic. If the probe fails, the container is removed from the load balancer.

These probes can be configured in the Container Apps YAML or Terraform configuration.

livenessProbe: httpGet: path: /api/health port: 80 initialDelaySeconds: 3 periodSeconds: 10 readinessProbe: httpGet: path: /api/health port: 80 initialDelaySeconds: 3 periodSeconds: 10

Write a custom Health check function:

Create a HTTP-triggered function and implement a dedicated health-check endpoint like /api/health that checks the status of internal dependencies and return a simple status like 200 OK. Monitor it using Azure Monitor, Application Insights.
Pravallika Kothaveeranna Gari 955 Reputation points Microsoft External Staff Moderator

2025-04-15T03:45:06.34+00:00

Ahmad, Jubair, Just checking in to see if the provided answer helped. If you have any further queries, do let us know.

Answer 1

@Ahmad, Jubair Thanks for your patience on this. I have checked with engineering team and posting the same here.

You can leverage Function App on Container App, this is a new experience in which everything would be managed from the Container App (with no Function App resource). You can add health probes directly on the Container App in this.

To get the new experience, the customer would create a Container App and select "Optimize for Azure Functions" in the creation wizard.

User's image

Refer to the below resources for more information.

Hope this helps, let me know if you have any further questions on this.

Share via

How to implement or add health checks for an Azure Function App running in a Container Apps environment, where the Function App is not polling a health API

0 additional answers

Your answer