WMI tutorial - extension package

Extensions 2.0 extensions are based on a YAML configuration file. Its minimal contents are:

• name - Must begin with custom: for custom extensions
• version
• author
• minDynatraceVersion - Minimum Dynatrace version to enforce a minimum version of the extension schema

In this step you will

1. Create a YAML extension file
2. Sign your extension
3. Create an extension package
4. Upload your extension to Dynatrace Hub.

1. Create YAML file

Use the following template.

yamlcopydownload
name: custom:demo.host-observability
version: # add version
minDynatraceVersion: "1.227"
author:
  name: # add your name

Save your extension.yaml and developer key and certificates using the following structure:

txtcopydownload
extensions/
  ├── developer.pem
  ├── developer.key
  └── extension/
      └── extension.yaml

2. Build your extension package

In the extensions parent directory, run the following command:

shellcopydownload
dt extension build

This command builds your extension package containing only the extension.zip archive and the extension.zip.sig signature file.

copydownload
my-custom-extension.zip
|    extension.zip
|    extension.zip.sig

Example successful output:

copydownload
C:\extension>dt extension build
Building .\extension.zip from .\extension
Adding file: .\extension\alerts\alert.json as alerts\alert.json
Adding file: .\extension\dashboards\dashboard.json as dashboards\dashboard.json
Adding file: .\extension\extension.yaml as extension.yaml
Wrote .\extension.zip file
Signing .\extension.zip using .\developer.pem certificate and .\developer.key private key
Wrote signature file .\extension.zip.sig
Wrote .\custom_my.company.extension-1.0.0.zip file
Extension built successfully! :-)

3. Upload your extension to Dynatrace Hub

Upload and activate your extension. Use local monitoring. For more information, see Manage WMI extensions.

Results

Your extension shows up in Dynatrace as Active.

Next step: WMI data source