Skip to content

[Azure AI Foundry] Add guardrails dashboard #14551

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Jul 16, 2025

Conversation

muthu-mps
Copy link
Contributor

@muthu-mps muthu-mps commented Jul 15, 2025

  • Enhancement

Proposed commit message

This PR adds support for monitoring the guardrails and controls. This is part of the Advanced monitoring capabilities in Azure for AI Foundry when accessed via API Management Services.

Checklist

  • I have reviewed tips for building integrations and this pull request is aligned with them.
  • I have verified that all data streams collect metrics or logs.
  • I have added an entry to my package's changelog.yml file.
  • I have verified that Kibana version constraints are current according to guidelines.
  • I have verified that any added dashboard complies with Kibana's Dashboard good practices

Author's Checklist

  • [ ]

How to test this PR locally

Related issues

Screenshots

azure_ai_foundry_guardrails_1 azure_ai_foundry_guardrails_2

@muthu-mps muthu-mps self-assigned this Jul 15, 2025
@muthu-mps muthu-mps added enhancement New feature or request dashboard Relates to a Kibana dashboard bug, enhancement, or modification. Team:Obs-InfraObs Observability Infrastructure Monitoring team [elastic/obs-infraobs-integrations] Integration:azure_ai_foundry Azure AI Foundry labels Jul 15, 2025
@elastic-vault-github-plugin-prod

🚀 Benchmarks report

To see the full report comment with /test benchmark fullreport

@muthu-mps muthu-mps marked this pull request as ready for review July 16, 2025 00:23
@muthu-mps muthu-mps requested a review from a team as a code owner July 16, 2025 00:23
@muthu-mps muthu-mps requested a review from ishleenk17 July 16, 2025 00:23
@elasticmachine
Copy link

💚 Build Succeeded

History

cc @muthu-mps

Copy link

@muthu-mps muthu-mps merged commit 5e5131b into elastic:main Jul 16, 2025
9 checks passed
@elastic-vault-github-plugin-prod

Package azure_ai_foundry - 0.5.0 containing this change is available at https://epr.elastic.co/package/azure_ai_foundry/0.5.0/

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Couple of comments:
1/ The description of the dashboard mentions "This dashboard primarily focuses on logs generated by the Azure AI Foundry service when connected through the API Management service." However, I can see that the dashboard shows a large number of non-log data such as request rates, error rates, model usage, latency which look like metrics. I think we should change this to "This dashboard focuses on logs and metrics generated by the Azure AI Foundry service when accessed via the API Management service only."

2/ Also, in the description body of the dashboard, remove mentions of "advanced monitoring". We can add an explanation of what Azure API Management service is and that the dashboard includes only data (performance, usage, prompts/responses) from using the API Management service. Something along the lines of "Azure API Management is a hybrid, multicloud management platform for APIs across all environments."

2/ It is not clear why we are calling this dashboard "Advanced monitoring" especially since it shows fairly basic, tablestakes data. Perhaps we should keep the previously suggested name focusing on the fact that the data we visualize is only for usage via the Azure API Management service which is the recommended way to use any Azure service anyway. So perhaps rename the dashboard to "API Management"

Copy link

@daniela-elastic daniela-elastic Jul 16, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few things:
1/ Replace description text with:
"The dashboard shows costs related to Azure Cognitive Services, including:

  • Total costs
  • Daily usage costs

Note: to enable collection of cost data, you need to enable the Azure Billing integration"

2/ replace "Total costs" with "Total cost" in the widget
3/ replace "Daily usage costs" with "Daily usage cost"
4/ replace "daily usage costs - by model" with "daily usage cost - by model"

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few things:
1/ replace header of description with that says "Azure AI Foundry Guardrails (Advanced Monitoring)" with "Azure AI Foundry Guardrails"

2/ why are we using a donut widget for error rate here but different widgets for error rates in the other dashboards?

3/ can we make the section named "Risk categories - by prompt input" more visible? Maybe bigger letters or something that makes it obvious that this is a new / separate section?

4/ replace "severity distribution by categories" with "severity distribution by category"

5/ make sure that the name capitalization of all your y-axis names of your widget is uniform. The guardrails dashboard has small caps in some cases, and in other cases first letter is capitalized. But then if you look at the other dashboards y-axis has first letter capitalization. We should be using this format.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

| 2/ why are we using a donut widget for error rate here but different widgets for error rates in the other dashboards?

This is because this will showcase which error_code happens most of the time. When it comes to guardrails we can show the content_filter error is happening most of the time.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1/ replace blocked request by category with 'blocked request - by category"
2/ replace serverity distribution by categories with 'Serverity distribution - by category"
3/ first letter capitalization of y-axis names (see previous comment)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1/ replace "primary metrics" with "Key metrics"
2/ explain that metrics reflect usage via both API Management service and .... (playground? Azure native APIs? Azure REST API? something else?) Can we work on explaining this as it's not clear what are the various ways in which you can generate such metrics

Copy link

@daniela-elastic daniela-elastic left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are number of outstanding issues that need to be fixed before we can launch - please see comments inline

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
dashboard Relates to a Kibana dashboard bug, enhancement, or modification. enhancement New feature or request Integration:azure_ai_foundry Azure AI Foundry Team:Obs-InfraObs Observability Infrastructure Monitoring team [elastic/obs-infraobs-integrations]
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants