Overview 💥
Liongard Metrics are the foundation for visibility, alerting, reporting, and automation across your environments. Metrics evaluate collected inspection data and determine whether specific conditions are met — such as configuration drift, security risk, compliance gaps, or operational changes.
Liongard provides two distinct Metric Libraries, each serving a different purpose:
Metrics within the Liongard Platform – where metrics are executed and evaluated
Liongard Metric Library (Community Library) – where metrics are shared and discovered
Understanding the difference between these two locations is essential to using metrics effectively.
Why This Matters 🤔
Confusion often arises because both locations use the term “Metric Library”, but they serve different roles:
Metrics must exist inside your Liongard platform to run
Community-shared metrics must be imported before use
Metrics must be enabled to display results and trigger alerts
🚨 Missing or disabled metrics are a common cause of empty dashboards, missing alerts, or incomplete reports.
1️⃣ Metrics Library Inside the Liongard Platform
This is the primary working area for metrics in your Liongard instance.
📍 Navigation Path: Admin → Metrics
🔍 What You’ll Find Here
Metric Type | Description |
Prebuilt Metrics | Default metrics provided and maintained by Liongard |
Custom Metrics | Metrics created by your team |
Cloned Metrics | Copies of Liongard metrics that you can safely modify |
✍️ What You Can Do
✅ View all metrics available in your instance
✍️ Create new custom metrics using the Metric Builder
📋 Clone Liongard-provided metrics
🛠️ Edit cloned or custom metrics
👁️ Enable or disable metrics for evaluation
⚠️ Important: Liongard default metrics are read-only. You must clone them before making any changes.
✅ Metric Enablement Requirement
For a metric to:
Display results
Trigger alerts
Appear in reports
…it must be enabled.
💡 Simply creating or importing a metric does not activate it.
📘 Related Documentation
2️⃣ Liongard Metric Library (Community Library)
The Liongard Metric Library is a community-driven repository where partners share metric queries.
📍 Access Options:
Support → Metrics Library (within the Liongard platform)
🌐 What the Community Library Is Used For
Feature | Description |
Shared Metrics | Metrics contributed by Liongard partners |
Discovery | Browse metrics created by other partners |
Collaboration | Learn new approaches and use cases |
Feedback | Comment on shared metrics |
Voting | Upvote metrics you find useful |
🔄 How Community Metrics Are Used
Browse metrics in the Community Library
Select a metric relevant to your use case
Import or recreate it in your Liongard platform
Enable the metric
Validate results against inspection data
AI Query Companion (Beta) 🤖
Liongard provides the AI Query Companion (Beta) to assist with metric creation.
🧠 What It Helps With
Generating metric query logic
Understanding available data paths
Accelerating metric development
⚠️ Beta Disclaimer:
AI-generated queries should always be reviewed
Validate logic before enabling metrics in production
📘 Learn more: AI Query Companion Documentation
Common Issues & Troubleshooting 🧑🏫
Issue | Likely Cause | Resolution |
Metric not showing results | Metric disabled | Enable the metric |
Metric shows no data | Inspector not collecting data | Verify inspection health |
Imported metric not running | Not added to Admin → Metrics | Create or import metric locally |
Cannot edit metric | Liongard default metric | Clone first, then edit |
Best Practices 🌟
📋 Always clone default metrics before modifying
🧪 Test metrics on a limited scope first
🏷️ Use clear naming conventions for custom metrics
🗂️ Document the purpose of complex metrics
👍 Upvote useful community metrics to improve discoverability
When to Contact Liongard Support 🦁
Contact Liongard Support if:
Metrics fail despite valid data and enablement
Metric results appear inconsistent or incorrect
The Metric Builder returns errors
Inspector data paths appear missing
Provide:
Metric name
Inspector name
Screenshot of metric configuration
Example affected asset