WMI data source tutorial

This is a step-by-step tutorial for building a WMI data source-based extension. You will build a WMI extension that runs on OneAgent and monitors a Windows host.

Before you begin

To successfully develop an Extensions 2.0 extension and be able to complete this tutorial, you need to fulfill the following prerequisites:

  • Admin access to a Dynatrace SaaS or Managed environment version 1.227+
  • Windows host (virtual machine)
  • OneAgent version 1.227+ deployed on the host
  • Dynatrace CLI
    • Python 3.8 or 3.9
    • Access to pip package installer for Python
    • Install dt-cli
      pip install dt-cli
      For more information, see Sign extensions.
  • Your root certificate uploaded to Dynatrace and on the OneAgent host

Step 1 Generate a developer certificate and key

dt extension genca
dt extension generate-developer-pem -o developer.pem --ca-crt ca.pem --ca-key ca.key --name 'JDoe'

The command generates the following files:

  • developer.pem - your developer certificate
  • ca.pem - your root certificate
  • ca.key - your root key

Step 2 Distribute the root certificate to Dynatrace components

Upload to the Dynatrace Credential Vault

  1. Go to Credential Vault.
  2. Select Add new credential.
  3. For Credential type, select Public Certificate.
  4. Select the Extension validation credential scope.
  5. Add a meaningful Credential name.
  6. Upload the Root certificate file.
  7. Select Save.

Upload to OneAgent host that runs the extension

  1. Go to the following directory:
    • Windows: C:\ProgramData\dynatrace\oneagent\agent\config
    • Linux: /var/lib/dynatrace/oneagent/agent/config/
  2. Go to the certificates folder (create it if it doesn't exist)
  3. Upload your root certificate (ca.pem) generated earlier

Your Dynatrace environment is ready to start creating your WMI extension.

Next step: Extension package