> ## Documentation Index
> Fetch the complete documentation index at: https://doc.lucidworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ConfigSync metrics and annotations

export const LwTemplate = ({title = "Key questions to get you started", icon = "sparkles", cta = "Powered by Agent Studio", linkHref = "https://lucidworks.com/demo/?utm_source=docs&utm_medium=referral&utm_campaign=docs_cta_ai"}) => {
  const [isLoaded, setIsLoaded] = useState(false);
  useEffect(() => {
    const timer = setTimeout(() => {
      setIsLoaded(true);
    }, 500);
    return () => clearTimeout(timer);
  }, []);
  return <div className="lw-template-container">
      <Card title={title} icon={icon}>
        {isLoaded && <span dangerouslySetInnerHTML={{
    __html: `<lw-template id="a029c1a9-28be-427e-b0e1-5d918920246a"></lw-template
            >`
  }} />}
        <Link href={linkHref} className="agent-studio-link text-left text-gray-600 gap-2 dark:text-gray-400 text-sm font-medium flex flex-row items-center hover:text-primary dark:hover:text-primary-light group-hover:text-primary group-hover:dark:text-primary-light">Powered by Lucidworks Agent Studio</Link>
      </Card>
    </div>;
};

[old doc.lw link]: https//doc.lucidworks.com/fusion/5.9/c7r9h8

[localhost link]: http://localhost:3000/docs/5/fusion/operations/config-sync/metrics

[mintlify link]: https://doc.lucidworks.com/docs/5/fusion/operations/config-sync/metrics

The metrics endpoint is available at `/actuator/prometheus` on the ConfigSync service. All custom metrics use the `configsync_` prefix for easy discovery and to avoid collisions with other applications.

<LwTemplate />

The following metrics are exposed by the ConfigSync service:

* `configsync_resource_update_errors_total` (`counter`) - The total number of errors encountered while updating resources.
* `configsync_out_of_sync` (`gauge`) - The number of resources that are out of sync. Only in `sub` mode.
* `configsync_sync_seconds` (`summary`) - The time taken to sync resources.
* `configsync_sync_seconds_max` (`gauge`) - The maximum time taken to sync resources.

## Annotations

Annotations are visual markers that appear on Grafana time-series graphs to highlight when specific events occurred. They provide context by overlaying event information directly onto your graphs, making it easier to correlate Fusion system behavior with ConfigSync activities.

When monitoring ConfigSync in Grafana graphs, annotations help you:

* **Identify the cause of metric changes** - Correlate spikes or dips in metrics with specific ConfigSync events like Git commits or Fusion configuration updates
* **Track deployment timelines** - Visualize when configuration changes were applied to your Fusion cluster
* **Debug synchronization issues** - Pinpoint when files changed in Git versus when they were applied to Fusion

Annotations in Grafana are created using Prometheus queries that trigger when certain conditions are met. The annotation appears as a vertical line or marker on your dashboard at the exact time the event occurred. You can hover over the annotation to see additional details about the event.

The metrics available to use in annotations are:

* `configsync_git_file_changes_total` (`counter`) - The number of files changes in Git from Fusion.
* `configsync_fusion_updates_total` (`counter`) - The number of operations applied to Fusion from Git.
* `configsync_git_commits_total` (`counter`) - The number of commits by type. You can use labels to filter by the type of commit.
  * `updates-from-fusion` - Updates created by ConfigSync
  * `explicit` - Updates created by users and applied to Fusion

## Example Grafana annotation queries

The following example queries can be used as annotation sources in Grafana.

### Annotate when Git files changed

`increase(configsync_git_file_changes_total[1m]) > 0`

### Annotate when Fusion was updated

`increase(configsync_fusion_updates_total[1m]) > 0`

### Annotate explicit user commits

`increase(configsync_git_commits_total{commit_type="explicit"}[1m]) > 0`