Data configurationGrafana integrationsIntegrations referenceWindows integration

Windows Integration for Grafana Cloud

The Windows integration for Grafana Cloud enables Grafana Agent to collect metrics related to the operating system running on Windows, including aspects like CPU usage, load average, memory usage, along with disk and networking I/O. This integration includes a useful prebuilt dashboard to help you monitor and visualize these metrics.

Install Windows integration for Grafana Cloud

  1. In your Grafana Cloud instance, click Integrations and Connections (lightning bolt icon), then click on the Windows tile to install the integration.
  2. Once the integration is installed, follow the steps on the Configuration Details page to set up Grafana Agent to automatically scrape and send Windows metrics to your Grafana Cloud Instance.

Post-install configuration for the Windows integration

This integration supports metrics and logs from your Windows instances. In order to see those signals correlated on the same dashboard, job and agent_hostname labels must match for windows_exporter (integrations) and logs in the Agent configuration file.

The following configuration enables the Windows integration in Grafana agent and also configures Windows event log scraping for both the Application and System logs.

integrations:
  windows_exporter:
    enabled: true
  prometheus_remote_write:
    - url: http://cortex:9009/api/prom/push

logs:
  configs:
    - name: agent
      clients:
        - url: http://loki:3100/loki/api/v1/push
      positions:
        filename: /tmp/positions.yaml
      target_config:
        sync_period: 10s
        
    scrape_configs:
      - job_name: integrations/windows-exporter-application
        windows_events:
          use_incoming_timestamp: true
          bookmark_path: "./bookmark-application.xml"
          eventlog_name: "Application"
          xpath_query: '*'
          labels:
            job: integrations/windows_exporter
        relabel_configs:
          - source_labels: ['computer']
            target_label: 'agent_hostname'  
        pipeline_stages:
          - json:
              expressions:
                source: source
          - labels:
              source:   

      - job_name: integrations/windows-exporter-system
        windows_events:
          use_incoming_timestamp: true
          bookmark_path: "./bookmark-system.xml"
          eventlog_name: "System"
          xpath_query: '*'
          labels:
            job: integrations/windows_exporter
        relabel_configs:
          - source_labels: ['computer']
            target_label: 'agent_hostname'
        pipeline_stages:
          - json:
              expressions:
                source: source
          - labels:
              source:

For a full description of configuration options, see windows_exporter_config in the Grafana Agent documentation.

Dashboards

After you have successfully configured the Windows integration, two prebuilt dashboards are installed in your Grafana instance to help you monitor your Windows metrics and logs.

The overview dashboard gives a general overview of your Windows metrics. The dashboard shows aggregated statistics of all Windows instances and it can also show statistics of individual instances based on the selected hostname. The logs dashboard allows your to monitor logs for your windows events.

Windows overview dashboard 1

Windows logs dashboard

Metrics captured by Windows integration for Grafana Cloud

For a complete list of all metrics that are automatically written to your Grafana Cloud instance by connecting your Windows instance through this integration, refer to Windows exporter metrics.

Cost

By connecting your Windows integration to Grafana Cloud you might incur charges. For more information, use the following links:

For an increase in the number of active series that your Grafana Cloud account uses for metrics included in each Cloud tier, see Active series and dpm usage and Cloud tier pricing.