agent

package
v0.54.0-rc.4 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 14, 2024 License: Apache-2.0 Imports: 20 Imported by: 0

Documentation

Overview

Package agent includes helpers related to the Datadog Agent on Windows

Package agent includes helpers related to the Datadog Agent on Windows

Index

Constants

View Source
const (
	// DatadogCodeSignatureThumbprint is the thumbprint of the Datadog Code Signing certificate
	// Valid From: May 2023
	// Valid To:   May 2025
	DatadogCodeSignatureThumbprint = `B03F29CC07566505A718583E9270A6EE17678742`
	// RegistryKeyPath is the root registry key that the Datadog Agent uses to store some state
	RegistryKeyPath = "HKLM:\\SOFTWARE\\Datadog\\Datadog Agent"
	// DefaultInstallPath is the default install path for the Datadog Agent
	DefaultInstallPath = `C:\Program Files\Datadog\Datadog Agent`
	// DefaultConfigRoot is the default config root for the Datadog Agent
	DefaultConfigRoot = `C:\ProgramData\Datadog`
	// DefaultAgentUserName is the default user name for the Datadog Agent
	DefaultAgentUserName = `ddagentuser`
)

Variables

This section is empty.

Functions

func GetAgentUserFromRegistry

func GetAgentUserFromRegistry(host *components.RemoteHost) (string, string, error)

GetAgentUserFromRegistry gets the domain and username that the agent was installed with from the registry

func GetBetaMSIURL

func GetBetaMSIURL(version string, arch string) (string, error)

GetBetaMSIURL returns the URL for the beta agent MSI majorVersion: 6, 7 arch: x86_64

func GetChannelURL

func GetChannelURL(channel string) (string, error)

GetChannelURL returns the URL for the channel name channel: beta, stable

func GetConfigRootFromRegistry

func GetConfigRootFromRegistry(host *components.RemoteHost) (string, error)

GetConfigRootFromRegistry gets the config root from the registry, e.g. C:\ProgramData\Datadog

func GetDatadogAgentProductCode

func GetDatadogAgentProductCode(host *components.RemoteHost) (string, error)

GetDatadogAgentProductCode returns the product code GUID for the Datadog Agent

func GetInstallPathFromRegistry

func GetInstallPathFromRegistry(host *components.RemoteHost) (string, error)

GetInstallPathFromRegistry gets the install path from the registry, e.g. C:\Program Files\Datadog\Datadog Agent

func GetLatestMSIURL

func GetLatestMSIURL(majorVersion string, arch string) string

GetLatestMSIURL returns the URL for the latest agent MSI majorVersion: 6, 7 arch: x86_64

func GetMSIURL

func GetMSIURL(channel string, version string, arch string) (string, error)

GetMSIURL returns the URL for the agent MSI channel: beta, stable majorVersion: 6, 7 arch: x86_64

func GetPipelineMSIURL

func GetPipelineMSIURL(pipelineID string, majorVersion string, arch string) (string, error)

GetPipelineMSIURL returns the URL for the agent MSI built by the pipeline majorVersion: 6, 7 arch: x86_64

func GetStableMSIURL

func GetStableMSIURL(version string, arch string) (string, error)

GetStableMSIURL returns the URL for the stable agent MSI majorVersion: 6, 7 arch: x86_64

func HasValidDatadogCodeSignature

func HasValidDatadogCodeSignature(host *components.RemoteHost, path string) error

HasValidDatadogCodeSignature an error if the file at the given path is not validy signed by the Datadog Code Signing certificate

func InstallAgent

func InstallAgent(host *components.RemoteHost, options ...InstallAgentOption) (string, error)

InstallAgent installs the agent and returns the remote MSI path and any errors

func LookupArchFromEnv

func LookupArchFromEnv() (string, bool)

LookupArchFromEnv looks at environment variabes to select the agent arch, if the value is found it is returned along with true, otherwise a default value and false are returned.

WINDOWS_AGENT_ARCH: The arch of the agent, x86_64

Default arch: x86_64

func LookupChannelFromEnv

func LookupChannelFromEnv() (string, bool)

LookupChannelFromEnv looks at environment variabes to select the agent channel, if the value is found it is returned along with true, otherwise a default value and false are returned.

WINDOWS_AGENT_CHANNEL: beta, stable

Default channel: stable

func LookupChannelURLFromEnv

func LookupChannelURLFromEnv() (string, bool)

LookupChannelURLFromEnv looks at environment variabes to select the agent channel URL, if the value is found it is returned along with true, otherwise a default value and false are returned.

WINDOWS_AGENT_CHANNEL_URL: URL to installers_v2.json

See also LookupChannelFromEnv()

Default channel: stable

func LookupVersionFromEnv

func LookupVersionFromEnv() (string, bool)

LookupVersionFromEnv looks at environment variabes to select the agent version, if the value is found it is returned along with true, otherwise a default value and false are returned.

In order of priority:

WINDOWS_AGENT_VERSION: The complete version, e.g. 7.49.0-1, 7.49.0-rc.3-1, or a major version, e.g. 7

AGENT_MAJOR_VERSION: The major version of the agent, 6 or 7

If only a major version is provided, the latest version of that major version is used.

Default version: 7

func RepairAllAgent

func RepairAllAgent(host *components.RemoteHost, args string, logPath string) error

RepairAllAgent repairs the Datadog Agent

func TestAgentVersion

func TestAgentVersion(t *testing.T, expected string, actual string) bool

TestAgentVersion compares the major.minor.patch-prefix parts of two agent versions

func TestValidDatadogCodeSignatures

func TestValidDatadogCodeSignatures(t *testing.T, host *components.RemoteHost, paths []string) bool

TestValidDatadogCodeSignatures verifies that the files at the given paths are validly signed by the Datadog Code Signing certificate This test is skipped if the verify_code_signature parameter is set to false.

func UninstallAgent

func UninstallAgent(host *components.RemoteHost, logPath string) error

UninstallAgent uninstalls the Datadog Agent

Types

type InstallAgentOption

type InstallAgentOption = func(*InstallAgentParams) error

InstallAgentOption is an optional function parameter type for InstallAgentParams options

func WithAPIKey

func WithAPIKey(apiKey string) InstallAgentOption

WithAPIKey specifies the APIKEY parameter.

func WithAPMEnabled added in v0.54.0

func WithAPMEnabled(apmEnabled string) InstallAgentOption

WithAPMEnabled specifies the APM_ENABLED parameter.

func WithAgentUser

func WithAgentUser(username string) InstallAgentOption

WithAgentUser specifies the DDAGENTUSER_NAME parameter.

func WithAgentUserPassword

func WithAgentUserPassword(password string) InstallAgentOption

WithAgentUserPassword specifies the DDAGENTUSER_PASSWORD parameter.

func WithApplicationDataDirectory added in v0.54.0

func WithApplicationDataDirectory(applicationDataDirectory string) InstallAgentOption

WithApplicationDataDirectory specifies the APPLICATIONDATADIRECTORY parameter.

func WithCmdPort added in v0.54.0

func WithCmdPort(cmdPort string) InstallAgentOption

WithCmdPort specifies the CMD_PORT parameter.

func WithDdURL

func WithDdURL(ddURL string) InstallAgentOption

WithDdURL specifies the DD_URL parameter.

func WithFakeIntake

func WithFakeIntake(fakeIntake *components.FakeIntake) InstallAgentOption

WithFakeIntake configures the Agent to use a fake intake URL.

func WithHostname added in v0.54.0

func WithHostname(hostname string) InstallAgentOption

WithHostname specifies the HOSTNAME parameter.

func WithInstallLogFile

func WithInstallLogFile(logFileName string) InstallAgentOption

WithInstallLogFile specifies the file on the local test runner to save the MSI install logs.

func WithLastStablePackage

func WithLastStablePackage() InstallAgentOption

WithLastStablePackage specifies to use the last stable installation package.

func WithLogsDdURL added in v0.54.0

func WithLogsDdURL(logsDdURL string) InstallAgentOption

WithLogsDdURL specifies the LOGS_DD_URL parameter.

func WithLogsEnabled added in v0.54.0

func WithLogsEnabled(logsEnabled string) InstallAgentOption

WithLogsEnabled specifies the LOGS_ENABLED parameter.

func WithPackage

func WithPackage(agentPackage *Package) InstallAgentOption

WithPackage specifies the Agent installation package.

func WithProcessDdURL added in v0.54.0

func WithProcessDdURL(processDdURL string) InstallAgentOption

WithProcessDdURL specifies the PROCESS_DD_URL parameter.

func WithProcessDiscoveryEnabled added in v0.54.0

func WithProcessDiscoveryEnabled(processDiscoveryEnabled string) InstallAgentOption

WithProcessDiscoveryEnabled specifies the PROCESS_DISCOVERY_ENABLED parameter.

func WithProcessEnabled added in v0.54.0

func WithProcessEnabled(processEnabled string) InstallAgentOption

WithProcessEnabled specifies the PROCESS_ENABLED parameter, which controls process_collection.

func WithProjectLocation added in v0.54.0

func WithProjectLocation(projectLocation string) InstallAgentOption

WithProjectLocation specifies the PROJECTLOCATION parameter.

func WithProxyHost added in v0.54.0

func WithProxyHost(proxyHost string) InstallAgentOption

WithProxyHost specifies the PROXY_HOST parameter.

func WithProxyPassword added in v0.54.0

func WithProxyPassword(proxyPassword string) InstallAgentOption

WithProxyPassword specifies the PROXY_PASSWORD parameter.

func WithProxyPort added in v0.54.0

func WithProxyPort(proxyPort string) InstallAgentOption

WithProxyPort specifies the PROXY_PORT parameter.

func WithProxyUser added in v0.54.0

func WithProxyUser(proxyUser string) InstallAgentOption

WithProxyUser specifies the PROXY_USER parameter.

func WithSite

func WithSite(site string) InstallAgentOption

WithSite specifies the SITE parameter.

func WithTags added in v0.54.0

func WithTags(tags string) InstallAgentOption

WithTags specifies the TAGS parameter.

func WithTraceDdURL added in v0.54.0

func WithTraceDdURL(traceDdURL string) InstallAgentOption

WithTraceDdURL specifies the TRACE_DD_URL parameter.

func WithValidAPIKey

func WithValidAPIKey() InstallAgentOption

WithValidAPIKey sets a valid API key fetched from the runner secret store.

func WithWixFailWhenDeferred

func WithWixFailWhenDeferred() InstallAgentOption

WithWixFailWhenDeferred sets the WixFailWhenDeferred parameter.

type InstallAgentParams

type InstallAgentParams struct {
	Package *Package
	// Path on local test runner to save the MSI install log
	LocalInstallLogFile string

	msi.InstallAgentParams
	// Installer parameters
	WixFailWhenDeferred      string `installer_arg:"WIXFAILWHENDEFERRED"`
	ProjectLocation          string `installer_arg:"PROJECTLOCATION"`
	ApplicationDataDirectory string `installer_arg:"APPLICATIONDATADIRECTORY"`
	// Installer parameters for agent config
	APIKey                  string `installer_arg:"APIKEY"`
	Tags                    string `installer_arg:"TAGS"`
	Hostname                string `installer_arg:"HOSTNAME"`
	CmdPort                 string `installer_arg:"CMD_PORT"`
	ProxyHost               string `installer_arg:"PROXY_HOST"`
	ProxyPort               string `installer_arg:"PROXY_PORT"`
	ProxyUser               string `installer_arg:"PROXY_USER"`
	ProxyPassword           string `installer_arg:"PROXY_PASSWORD"`
	LogsDdURL               string `installer_arg:"LOGS_DD_URL"`
	ProcessDdURL            string `installer_arg:"PROCESS_DD_URL"`
	TraceDdURL              string `installer_arg:"TRACE_DD_URL"`
	LogsEnabled             string `installer_arg:"LOGS_ENABLED"`
	ProcessEnabled          string `installer_arg:"PROCESS_ENABLED"`
	ProcessDiscoveryEnabled string `installer_arg:"PROCESS_DISCOVERY_ENABLED"`
	APMEnabled              string `installer_arg:"APM_ENABLED"`
}

InstallAgentParams are the parameters used for installing the Agent using msiexec.

type Package

type Package struct {
	// PipelineID is the pipeline ID used to lookup the MSI URL from the CI pipeline artifacts.
	PipelineID string
	// Channel is the channel used to lookup the MSI URL for the Version from the installers_v2.json file.
	Channel string
	// Version is the version of the MSI, e.g. 7.49.0-1, 7.49.0-rc.3-1, or a major version, e.g. 7
	Version string
	// Arch is the architecture of the MSI, e.g. x86_64
	Arch string
	// URL is the URL the MSI can be downloaded from
	URL string
}

Package contains identifying information about an Agent MSI package.

func GetLastStablePackageFromEnv

func GetLastStablePackageFromEnv() (*Package, error)

GetLastStablePackageFromEnv returns the latest stable agent MSI URL.

These environment variables are mutually exclusive, only one should be set, listed here in the order they are considered:

LAST_STABLE_WINDOWS_AGENT_MSI_URL: manually provided URL (all other parameters are informational only)

LAST_STABLE_VERSION: The complete version, e.g. 7.49.0-1, 7.49.0-rc.3-1, or a major version, e.g. 7, arch and channel are used

The value of LAST_STABLE_VERSION is set in release.json, and can be acquired by running: invoke release.get-release-json-value "last_stable::$AGENT_MAJOR_VERSION"

func GetPackageFromEnv

func GetPackageFromEnv() (*Package, error)

GetPackageFromEnv looks at environment variabes to select the Agent MSI URL.

The returned Package contains the MSI URL and other identifying information. Some Package fields will be populated but may not be related to the returned URL. For example, if a URL is provided directly, the Channel, Version, and Arch fields have no effect on the returned URL. They are returned anyway so they can be used for other purposes, such as logging, stack name, instance options, test assertions, etc.

These environment variables are mutually exclusive, only one should be set, listed here in the order they are considered:

WINDOWS_AGENT_MSI_URL: manually provided URL (all other parameters are informational only)

CI_PIPELINE_ID: use the URL from a specific CI pipeline, major version and arch are used, channel is blank

WINDOWS_AGENT_VERSION: The complete version, e.g. 7.49.0-1, 7.49.0-rc.3-1, or a major version, e.g. 7, arch and channel are used

Other environment variables:

WINDOWS_AGENT_CHANNEL: beta or stable

WINDOWS_AGENT_ARCH: The arch of the agent, x86_64

If a channel is not provided and the version contains `-rc.`, the beta channel is used.

See other Lookup*FromEnv functions for more options and details.

If none of the above are set, the latest stable version is used.

func (*Package) AgentVersion

func (p *Package) AgentVersion() string

AgentVersion returns a string containing version number and the pre only, e.g. `0.0.0-beta.1`

Directories

Path Synopsis
installers
v2
Package installers processes the installers_v2.json file
Package installers processes the installers_v2.json file

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL