Documentation ¶
Overview ¶
Code generated by tutone: DO NOT EDIT
Index ¶
- Constants
- Variables
- type DiscoveryManifest
- type ErrNonZeroExitCode
- type GenericProcess
- type GoTaskError
- type GoTaskGeneralError
- type InstallerContext
- func (i *InstallerContext) RecipeNamesProvided() bool
- func (i *InstallerContext) RecipePathsProvided() bool
- func (i *InstallerContext) RecipesProvided() bool
- func (i *InstallerContext) ShouldInstallApm() bool
- func (i *InstallerContext) ShouldInstallInfraAgent() bool
- func (i *InstallerContext) ShouldInstallIntegrations() bool
- func (i *InstallerContext) ShouldInstallLogging() bool
- func (i *InstallerContext) SkipKeywords() []string
- func (i *InstallerContext) SkipNames() []string
- func (i *InstallerContext) SkipTypes() []string
- type MatchedProcess
- type NRQL
- type OpenInstallationAttributes
- type OpenInstallationCategory
- type OpenInstallationLogMatch
- type OpenInstallationOperatingSystem
- type OpenInstallationPlatform
- type OpenInstallationPlatformFamily
- type OpenInstallationPostInstallConfiguration
- type OpenInstallationPreInstallConfiguration
- type OpenInstallationQuickstartEntityType
- type OpenInstallationQuickstartsFilter
- type OpenInstallationRecipe
- func (r *OpenInstallationRecipe) HasApplicationTargetType() bool
- func (r *OpenInstallationRecipe) HasHostTargetType() bool
- func (r *OpenInstallationRecipe) HasKeyword(keyword string) bool
- func (r *OpenInstallationRecipe) HasTargetType(t OpenInstallationTargetType) bool
- func (r *OpenInstallationRecipe) IsApm() bool
- func (r *OpenInstallationRecipe) PostInstallMessage() string
- func (r *OpenInstallationRecipe) PreInstallMessage() string
- func (r *OpenInstallationRecipe) SetRecipeVar(key string, value string)
- func (r OpenInstallationRecipe) String() string
- func (r *OpenInstallationRecipe) UnmarshalYAML(unmarshal func(interface{}) error) error
- type OpenInstallationRecipeInputVariable
- type OpenInstallationRecipeInstallTarget
- type OpenInstallationStability
- type OpenInstallationSuccessLinkConfig
- type OpenInstallationSuccessLinkType
- type OpenInstallationTargetType
- type RecipeVars
Constants ¶
const ( InfraAgentRecipeName = "infrastructure-agent-installer" LoggingRecipeName = "logs-integration" )
const (
ApmKeyword = "Apm"
)
Variables ¶
var ( // ErrInterrupt represents a context cancellation. ErrInterrupt = errors.New("operation canceled") )
var ErrorFetchingInsightsInsertKey = errors.New("error retrieving Insights insert key")
var ErrorFetchingLicenseKey = errors.New("Oops, we're having some difficulties fetching your license key. Please try again later, or see our documentation for installing manually https://docs.newrelic.com/docs/using-new-relic/cross-product-functions/install-configure/install-new-relic")
nolint: golint
var OpenInstallationCategoryTypes = struct { // COMMUNITY category COMMUNITY OpenInstallationCategory // NEWRELIC category NEWRELIC OpenInstallationCategory }{ COMMUNITY: "COMMUNITY", NEWRELIC: "NEWRELIC", }
var OpenInstallationOperatingSystemTypes = struct { // MacOS operating system DARWIN OpenInstallationOperatingSystem // Linux-based operating system LINUX OpenInstallationOperatingSystem // Windows operating system WINDOWS OpenInstallationOperatingSystem }{ DARWIN: "DARWIN", LINUX: "LINUX", WINDOWS: "WINDOWS", }
var OpenInstallationPlatformFamilyTypes = struct { // Debian distribution family DEBIAN OpenInstallationPlatformFamily // RHEL distribution family RHEL OpenInstallationPlatformFamily // openSUSE distribution family SUSE OpenInstallationPlatformFamily }{ DEBIAN: "DEBIAN", RHEL: "RHEL", SUSE: "SUSE", }
var OpenInstallationPlatformTypes = struct { // Amazon Linux operating system AMAZON OpenInstallationPlatform // CentOS operating system CENTOS OpenInstallationPlatform // Debian operating system DEBIAN OpenInstallationPlatform // RedHat Enterprise Linux operating system REDHAT OpenInstallationPlatform // SUSE operating system SUSE OpenInstallationPlatform // Ubuntu operating system UBUNTU OpenInstallationPlatform }{ AMAZON: "AMAZON", CENTOS: "CENTOS", DEBIAN: "DEBIAN", REDHAT: "REDHAT", SUSE: "SUSE", UBUNTU: "UBUNTU", }
var OpenInstallationStabilityTypes = struct { // Recipe is disabled DISABLED OpenInstallationStability // Recipe is experimental EXPERIMENTAL OpenInstallationStability // Recipe is stable STABLE OpenInstallationStability }{ DISABLED: "DISABLED", EXPERIMENTAL: "EXPERIMENTAL", STABLE: "STABLE", }
var OpenInstallationSuccessLinkTypeTypes = struct { // Explorer link EXPLORER OpenInstallationSuccessLinkType // Host entity link HOST OpenInstallationSuccessLinkType }{ EXPLORER: "EXPLORER", HOST: "HOST", }
var OpenInstallationTargetTypeTypes = struct { // APM agent installation APPLICATION OpenInstallationTargetType // Cloud provider installation CLOUD OpenInstallationTargetType // Docker container installation DOCKER OpenInstallationTargetType // Bare metal, virtual machine, or host-based installation HOST OpenInstallationTargetType // Kubernetes installation KUBERNETES OpenInstallationTargetType // Serverless installation SERVERLESS OpenInstallationTargetType }{ APPLICATION: "APPLICATION", CLOUD: "CLOUD", DOCKER: "DOCKER", HOST: "HOST", KUBERNETES: "KUBERNETES", SERVERLESS: "SERVERLESS", }
var (
RecipeVariables = map[string]string{}
)
Functions ¶
This section is empty.
Types ¶
type DiscoveryManifest ¶
type DiscoveryManifest struct { Hostname string `json:"hostname"` KernelArch string `json:"kernelArch"` KernelVersion string `json:"kernelVersion"` OS string `json:"os"` Platform string `json:"platform"` PlatformFamily string `json:"platformFamily"` PlatformVersion string `json:"platformVersion"` MatchedProcesses []MatchedProcess `json:"processes"` DiscoveredProcesses []GenericProcess }
DiscoveryManifest contains the discovered information about the host.
func (*DiscoveryManifest) AddMatchedProcess ¶ added in v0.18.17
func (d *DiscoveryManifest) AddMatchedProcess(p MatchedProcess)
AddMatchedProcess adds a discovered process to the underlying manifest.
func (*DiscoveryManifest) ConstrainRecipes ¶ added in v0.24.0
func (d *DiscoveryManifest) ConstrainRecipes(allRecipes []OpenInstallationRecipe) []OpenInstallationRecipe
type ErrNonZeroExitCode ¶ added in v0.27.0
type ErrNonZeroExitCode struct { GoTaskError // contains filtered or unexported fields }
ErrNonZeroExitCode represents a non-zero exit code error reported by go-task.
func NewNonZeroExitCode ¶ added in v0.27.0
func NewNonZeroExitCode(originalError GoTaskError, additionalContext string) ErrNonZeroExitCode
func (ErrNonZeroExitCode) Error ¶ added in v0.27.0
func (e ErrNonZeroExitCode) Error() string
type GenericProcess ¶
GenericProcess is an abstracted representation of a process.
type GoTaskError ¶ added in v0.27.0
func NewGoTaskGeneralError ¶ added in v0.27.0
func NewGoTaskGeneralError(err error) GoTaskError
type GoTaskGeneralError ¶ added in v0.27.0
type GoTaskGeneralError struct {
// contains filtered or unexported fields
}
GoTaskError represents a task failure reported by go-task.
func (GoTaskGeneralError) Error ¶ added in v0.27.0
func (e GoTaskGeneralError) Error() string
func (GoTaskGeneralError) SetError ¶ added in v0.27.0
func (e GoTaskGeneralError) SetError(msg string)
func (GoTaskGeneralError) TaskPath ¶ added in v0.27.2
func (e GoTaskGeneralError) TaskPath() []string
type InstallerContext ¶ added in v0.28.0
type InstallerContext struct { AssumeYes bool RecipeNames []string RecipePaths []string // LocalRecipes is the path to a local recipe directory from which to load recipes. LocalRecipes string SkipIntegrations bool SkipLoggingInstall bool SkipApm bool SkipInfraInstall bool }
nolint: maligned
func (*InstallerContext) RecipeNamesProvided ¶ added in v0.28.0
func (i *InstallerContext) RecipeNamesProvided() bool
func (*InstallerContext) RecipePathsProvided ¶ added in v0.28.0
func (i *InstallerContext) RecipePathsProvided() bool
func (*InstallerContext) RecipesProvided ¶ added in v0.28.0
func (i *InstallerContext) RecipesProvided() bool
func (*InstallerContext) ShouldInstallApm ¶ added in v0.28.0
func (i *InstallerContext) ShouldInstallApm() bool
func (*InstallerContext) ShouldInstallInfraAgent ¶ added in v0.28.0
func (i *InstallerContext) ShouldInstallInfraAgent() bool
func (*InstallerContext) ShouldInstallIntegrations ¶ added in v0.28.0
func (i *InstallerContext) ShouldInstallIntegrations() bool
func (*InstallerContext) ShouldInstallLogging ¶ added in v0.28.0
func (i *InstallerContext) ShouldInstallLogging() bool
func (*InstallerContext) SkipKeywords ¶ added in v0.28.0
func (i *InstallerContext) SkipKeywords() []string
func (*InstallerContext) SkipNames ¶ added in v0.28.0
func (i *InstallerContext) SkipNames() []string
func (*InstallerContext) SkipTypes ¶ added in v0.28.0
func (i *InstallerContext) SkipTypes() []string
type MatchedProcess ¶ added in v0.18.17
type MatchedProcess struct { GenericProcess MatchingPattern string MatchingRecipe OpenInstallationRecipe }
type NRQL ¶
type NRQL string
NRQL - This scalar represents a NRQL query string.
See the [NRQL Docs](https://docs.newrelic.com/docs/insights/nrql-new-relic-query-language/nrql-resources/nrql-syntax-components-functions) for more information about NRQL syntax.
type OpenInstallationAttributes ¶
type OpenInstallationAttributes struct { // Built-in parsing rulesets Logtype string `json:"logtype,omitempty" yaml:"logtype,omitempty"` }
OpenInstallationAttributes - Custom event data attributes
type OpenInstallationCategory ¶ added in v0.23.0
type OpenInstallationCategory string
OpenInstallationCategory - Categorization of a Quickstart
type OpenInstallationLogMatch ¶
type OpenInstallationLogMatch struct { // List of custom attributes, as key-value pairs, that can be used to send additional data with the logs which you can then query. Attributes OpenInstallationAttributes `json:"attributes,omitempty" yaml:"attributes,omitempty"` // Path to the log file or files. File string `json:"file,omitempty" yaml:"file,omitempty"` // Name of the log or logs. Name string `json:"name" yaml:"name"` // Regular expression for filtering records. Pattern string `json:"pattern,omitempty" yaml:"pattern,omitempty"` // Service name (Linux Only). Systemd string `json:"systemd,omitempty" yaml:"systemd,omitempty"` }
OpenInstallationLogMatch - Matches partial list of the Log forwarding parameters
type OpenInstallationOperatingSystem ¶
type OpenInstallationOperatingSystem string
OpenInstallationOperatingSystem - Operating System of target environment
type OpenInstallationPlatform ¶
type OpenInstallationPlatform string
OpenInstallationPlatform - Operating System distribution
type OpenInstallationPlatformFamily ¶
type OpenInstallationPlatformFamily string
OpenInstallationPlatformFamily - Operating System distribution family
type OpenInstallationPostInstallConfiguration ¶ added in v0.18.32
type OpenInstallationPostInstallConfiguration struct { // Message/Docs notice displayed to user after running the recipe Info string `json:"info,omitempty" yaml:"info,omitempty"` }
OpenInstallationPostInstallConfiguration - Optional post-install configuration items
type OpenInstallationPreInstallConfiguration ¶
type OpenInstallationPreInstallConfiguration struct { // Message/Docs notice displayed to user prior to running recipe Info string `json:"info,omitempty" yaml:"info,omitempty"` // Message/Docs notice displayed to user prior to running recipe Prompt string `json:"prompt,omitempty" yaml:"prompt,omitempty"` RequireAtDiscovery string `json:"requireAtDiscovery,omitempty" yaml:"requireAtDiscovery,omitempty"` }
OpenInstallationPreInstallConfiguration - Optional pre-install configuration items
type OpenInstallationQuickstartEntityType ¶ added in v0.23.0
type OpenInstallationQuickstartEntityType struct { // Domain of Entity Domain string `json:"domain" yaml:"domain"` // Type of Entity Type string `json:"type" yaml:"type"` }
OpenInstallationQuickstartEntityType - Entity type relation for Quickstart
type OpenInstallationQuickstartsFilter ¶ added in v0.23.0
type OpenInstallationQuickstartsFilter struct { // Categorization of Quickstart Category OpenInstallationCategory `json:"category,omitempty" yaml:"category,omitempty"` // Entity relationship for Quickstart EntityType OpenInstallationQuickstartEntityType `json:"entityType,omitempty" yaml:"entityType,omitempty"` // Name of the Quickstart Name string `json:"name" yaml:"name"` }
OpenInstallationQuickstartsFilter - Metadata used to filter for Quickstarts
type OpenInstallationRecipe ¶
type OpenInstallationRecipe struct { // Named list of dependencies for this recipe Dependencies []string `json:"dependencies" yaml:"dependencies"` // Description of the recipe Description string `json:"description" yaml:"description"` // Friendly name of the integration DisplayName string `json:"displayName,omitempty" yaml:"displayName,omitempty"` // The full contents of the recipe file (yaml) File string `json:"file" yaml:"file"` // The ID ID string `json:"id,omitempty" yaml:"id,omitempty"` // List of variables to prompt for input from the user InputVars []OpenInstallationRecipeInputVariable `json:"inputVars" yaml:"inputVars"` // Go-task's taskfile definition (see https://taskfile.dev/#/usage) Install string `json:"install" yaml:"install"` // Object representing the intended install target InstallTargets []OpenInstallationRecipeInstallTarget `json:"installTargets" yaml:"installTargets"` // Tags Keywords []string `json:"keywords" yaml:"keywords"` // # Partial list of possible Log forwarding parameters LogMatch []OpenInstallationLogMatch `json:"logMatch" yaml:"logMatch"` // Short unique handle for the name of the integration Name string `json:"name,omitempty" yaml:"name,omitempty"` // Object representing optional post-install configuration items PostInstall OpenInstallationPostInstallConfiguration `json:"postInstall,omitempty" yaml:"postInstall,omitempty"` // Object representing optional pre-install configuration items PreInstall OpenInstallationPreInstallConfiguration `json:"preInstall,omitempty" yaml:"preInstall,omitempty"` // List of process definitions used to match CLI process detection ProcessMatch []string `json:"processMatch" yaml:"processMatch"` // Metadata used to recommend and install Quickstarts Quickstarts OpenInstallationQuickstartsFilter `json:"quickstarts,omitempty" yaml:"quickstarts,omitempty"` // Github repository url Repository string `json:"repository" yaml:"repository"` // Indicates stability level of recipe Stability OpenInstallationStability `json:"stability,omitempty" yaml:"stability,omitempty"` // Metadata to support generating a URL after installation success SuccessLinkConfig OpenInstallationSuccessLinkConfig `json:"successLinkConfig,omitempty" yaml:"successLinkConfig,omitempty"` // NRQL the newrelic-cli uses to validate this recipe // is successfully sending data to New Relic ValidationNRQL NRQL `json:"validationNrql,omitempty" yaml:"validationNrql,omitempty"` }
OpenInstallationRecipe - Installation instructions and definition of an instrumentation integration
func (*OpenInstallationRecipe) HasApplicationTargetType ¶ added in v0.26.0
func (r *OpenInstallationRecipe) HasApplicationTargetType() bool
func (*OpenInstallationRecipe) HasHostTargetType ¶ added in v0.26.0
func (r *OpenInstallationRecipe) HasHostTargetType() bool
func (*OpenInstallationRecipe) HasKeyword ¶ added in v0.26.0
func (r *OpenInstallationRecipe) HasKeyword(keyword string) bool
func (*OpenInstallationRecipe) HasTargetType ¶ added in v0.26.0
func (r *OpenInstallationRecipe) HasTargetType(t OpenInstallationTargetType) bool
func (*OpenInstallationRecipe) IsApm ¶ added in v0.26.0
func (r *OpenInstallationRecipe) IsApm() bool
func (*OpenInstallationRecipe) PostInstallMessage ¶ added in v0.26.0
func (r *OpenInstallationRecipe) PostInstallMessage() string
func (*OpenInstallationRecipe) PreInstallMessage ¶ added in v0.26.0
func (r *OpenInstallationRecipe) PreInstallMessage() string
func (*OpenInstallationRecipe) SetRecipeVar ¶ added in v0.26.0
func (r *OpenInstallationRecipe) SetRecipeVar(key string, value string)
SetRecipeVar is responsible for including a new variable on the RecipeVariables struct, which is used by go-task executor.
func (OpenInstallationRecipe) String ¶ added in v0.28.0
func (r OpenInstallationRecipe) String() string
func (*OpenInstallationRecipe) UnmarshalYAML ¶ added in v0.26.0
func (r *OpenInstallationRecipe) UnmarshalYAML(unmarshal func(interface{}) error) error
The API response returns OpenInstallationRecipe.Install as a string. When specifying a recipe path, OpenInstallationRecipe.Install is a map[interface{}]interface{}. For this reason we need a custom unmarshal method for YAML.
type OpenInstallationRecipeInputVariable ¶
type OpenInstallationRecipeInputVariable struct { // Default value of variable Default string `json:"default,omitempty" yaml:"default,omitempty"` // Name of the variable Name string `json:"name" yaml:"name"` // Message to present to the user Prompt string `json:"prompt,omitempty" yaml:"prompt,omitempty"` // Indicates a password field Secret bool `json:"secret,omitempty" yaml:"secret,omitempty"` }
OpenInstallationRecipeInputVariable - Recipe input variable prompts displayed to the user prior to execution
type OpenInstallationRecipeInstallTarget ¶
type OpenInstallationRecipeInstallTarget struct { // OS kernel architecture KernelArch string `json:"kernelArch,omitempty" yaml:"kernelArch,omitempty"` // OS kernel version KernelVersion string `json:"kernelVersion,omitempty" yaml:"kernelVersion,omitempty"` // Operating system Os OpenInstallationOperatingSystem `json:"os,omitempty" yaml:"os,omitempty"` // Operating System distribution Platform OpenInstallationPlatform `json:"platform,omitempty" yaml:"platform,omitempty"` // Operating System distribution family PlatformFamily OpenInstallationPlatformFamily `json:"platformFamily,omitempty" yaml:"platformFamily,omitempty"` // OS distribution version PlatformVersion string `json:"platformVersion,omitempty" yaml:"platformVersion,omitempty"` // Target type Type OpenInstallationTargetType `json:"type,omitempty" yaml:"type,omitempty"` }
OpenInstallationRecipeInstallTarget - Matrix of supported installation criteria for this recipe
type OpenInstallationStability ¶ added in v0.23.0
type OpenInstallationStability string
OpenInstallationStability - Stability level of recipe
type OpenInstallationSuccessLinkConfig ¶ added in v0.23.0
type OpenInstallationSuccessLinkConfig struct { // An optional filter for appending to the URL Filter string `json:"filter,omitempty" yaml:"filter,omitempty"` // The type of the link to generate Type OpenInstallationSuccessLinkType `json:"type" yaml:"type"` }
OpenInstallationSuccessLinkConfig - Metadata to support generating a URL after installation success
type OpenInstallationSuccessLinkType ¶ added in v0.23.0
type OpenInstallationSuccessLinkType string
OpenInstallationSuccessLinkType - Success link type
type OpenInstallationTargetType ¶
type OpenInstallationTargetType string
OpenInstallationTargetType - Installation target type
type RecipeVars ¶
RecipeVars is used to pass dynamic data to recipes and go-task.
func (RecipeVars) ToSlice ¶ added in v0.28.0
func (r RecipeVars) ToSlice() []string