dynatrace

libbuildpack-dynatrace

Base Library for Go-based Cloud Foundry Buildpack integrations with Dynatrace.

Summary

The library provides the Hook struct that implements the libbuildpack.Hook interface that it's requested by the CF Buildpacks.

On the buildpacks, you're expected to provide a hook through a init() function where you can register such hook implementation. For example, a simple implementation could be,

import (
	"github.com/cloudfoundry/libbuildpack"
	"github.com/Dynatrace/libbuildpack-dynatrace"
)

func init() {
	libbuildpack.AddHook(dynatrace.NewHook("nodejs", "process"))
}

Configuration

The Hook will look for credentials in the configurations for existing services. It searches for service credentials depending on the binding type:

1. File-based: If the VCAP_SERVICES_FILE_PATH environment variable is set, the hook reads the VCAP_SERVICES JSON from the file at that path.
2. Environment variable: If the env var VCAP_SERVICES is set, it reads the JSON from the VCAP_SERVICES environment variable directly.

In both cases, we look for service names having the 'dynatrace' substring.

We support the following configuration fields,

For example,

cf create-user-provided-service dynatrace -p '{"environmentid":"...","apitoken":"..."}'

See more at the documentation for cf create-user-provided-service.

We also support standard Dynatrace environment variables.

Requirements

• Go 1.19 or higher.
• Deployment targets: Linux and Windows.
• Development and testing: Linux, Mac OS, and Windows.

Development

You can download or clone the repository.

You can run tests through,

go test ./...

By default, tests simulate the Linux platform. To test against a different target OS, use the -os flag:

go test ./... -os=windows
go test ./... -os=linux

If you modify/add interfaces, you may need to regenerate the mocks. For this you need gomock:

# To download Gomock
go get github.com/golang/mock/gomock
go install github.com/golang/mock/mockgen

# To generate the mocks
go generate