Documentation ¶
Overview ¶
Code generated by tutone: DO NOT EDIT
Index ¶
- Constants
- Variables
- type DiscoveryManifest
- type GenericProcess
- type LogMatch
- type LogMatchAttributes
- 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
- type OpenInstallationRecipeInputVariable
- type OpenInstallationRecipeInstallTarget
- type OpenInstallationStability
- type OpenInstallationSuccessLinkConfig
- type OpenInstallationSuccessLinkType
- type OpenInstallationTargetType
- type Recipe
- func (r *Recipe) AddVar(key string, value interface{})
- func (r *Recipe) HasApplicationTargetType() bool
- func (r *Recipe) HasHostTargetType() bool
- func (r *Recipe) HasKeyword(keyword string) bool
- func (r *Recipe) HasTargetType(t OpenInstallationTargetType) bool
- func (r *Recipe) IsApm() bool
- func (r *Recipe) PostInstallMessage() string
- func (r *Recipe) PreInstallMessage() string
- type RecipeVars
Constants ¶
const ( InfraAgentRecipeName = "infrastructure-agent-installer" LoggingRecipeName = "logs-integration" )
Variables ¶
var ErrInterrupt = errors.New("operation canceled")
ErrInterrupt represents a context cancellation.
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", }
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"` Processes []MatchedProcess `json:"processes"` }
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 []Recipe) []Recipe
type GenericProcess ¶
GenericProcess is an abstracted representation of a process.
type LogMatch ¶
type LogMatch struct { Name string `yaml:"name"` File string `yaml:"file"` Attributes LogMatchAttributes `yaml:"attributes,omitempty"` Pattern string `yaml:"pattern,omitempty"` Systemd string `yaml:"systemd,omitempty"` }
LogMatch represents a pattern that may match one or more logs on the underlying host.
type LogMatchAttributes ¶
type LogMatchAttributes struct {
LogType string `yaml:"logtype"`
}
LogMatchAttributes contains metadata about its parent LogMatch.
type MatchedProcess ¶ added in v0.18.17
type MatchedProcess struct { Command string `json:"command"` Process GenericProcess MatchingPattern string }
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"` }
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"` // Path to the log file or files. File string `json:"file,omitempty"` // Name of the log or logs. Name string `json:"name"` // Regular expression for filtering records. Pattern string `json:"pattern,omitempty"` // Service name (Linux Only). Systemd string `json:"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"` }
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"` // Message/Docs notice displayed to user prior to running recipe Prompt string `json:"prompt,omitempty"` }
OpenInstallationPreInstallConfiguration - Optional pre-install configuration items
type OpenInstallationQuickstartEntityType ¶ added in v0.23.0
type OpenInstallationQuickstartEntityType struct { // Domain of Entity Domain string `json:"domain"` // Type of Entity Type string `json:"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"` // Entity relationship for Quickstart EntityType OpenInstallationQuickstartEntityType `json:"entityType,omitempty"` // Name of the Quickstart Name string `json:"name"` }
OpenInstallationQuickstartsFilter - Metadata used to filter for Quickstarts
type OpenInstallationRecipe ¶
type OpenInstallationRecipe struct { // Named list of dependencies for this recipe Dependencies []string `json:"dependencies"` // Description of the recipe Description string `json:"description"` // Friendly name of the integration DisplayName string `json:"displayName,omitempty"` // The full contents of the recipe file (yaml) File string `json:"file"` // The ID ID string `json:"id,omitempty"` // List of variables to prompt for input from the user InputVars []OpenInstallationRecipeInputVariable `json:"inputVars"` // Go-task's taskfile definition (see https://taskfile.dev/#/usage) Install string `json:"install"` // Object representing the intended install target InstallTargets []OpenInstallationRecipeInstallTarget `json:"installTargets"` // Tags Keywords []string `json:"keywords"` // # Partial list of possible Log forwarding parameters LogMatch []OpenInstallationLogMatch `json:"logMatch"` // Short unique handle for the name of the integration Name string `json:"name,omitempty"` // Object representing optional post-install configuration items PostInstall OpenInstallationPostInstallConfiguration `json:"postInstall,omitempty"` // Object representing optional pre-install configuration items PreInstall OpenInstallationPreInstallConfiguration `json:"preInstall,omitempty"` // List of process definitions used to match CLI process detection ProcessMatch []string `json:"processMatch"` // Metadata used to recommend and install Quickstarts Quickstarts OpenInstallationQuickstartsFilter `json:"quickstarts,omitempty"` // Github repository url Repository string `json:"repository"` // Indicates stability level of recipe Stability OpenInstallationStability `json:"stability,omitempty"` // Metadata to support generating a URL after installation success SuccessLinkConfig OpenInstallationSuccessLinkConfig `json:"successLinkConfig,omitempty"` // NRQL the newrelic-cli uses to validate this recipe // is successfully sending data to New Relic ValidationNRQL NRQL `json:"validationNrql,omitempty"` }
OpenInstallationRecipe - Installation instructions and definition of an instrumentation integration
type OpenInstallationRecipeInputVariable ¶
type OpenInstallationRecipeInputVariable struct { // Default value of variable Default string `json:"default,omitempty"` // Name of the variable Name string `json:"name"` // Message to present to the user Prompt string `json:"prompt,omitempty"` // Indicates a password field Secret bool `json:"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"` // OS kernel version KernelVersion string `json:"kernelVersion,omitempty"` // Operating system Os OpenInstallationOperatingSystem `json:"os,omitempty"` // Operating System distribution Platform OpenInstallationPlatform `json:"platform,omitempty"` // Operating System distribution family PlatformFamily OpenInstallationPlatformFamily `json:"platformFamily,omitempty"` // OS distribution version PlatformVersion string `json:"platformVersion,omitempty"` // Target type Type OpenInstallationTargetType `json:"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"` // The type of the link to generate Type OpenInstallationSuccessLinkType `json:"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 Recipe ¶
type Recipe struct { ID string `json:"id" yaml:"id"` Description string `json:"description" yaml:"description"` DisplayName string `json:"displayName" yaml:"displayName"` Dependencies []string `json:"dependencies" yaml:"dependencies"` Stability OpenInstallationStability `json:"stability" yaml:"stability"` Quickstarts OpenInstallationQuickstartsFilter `json:"quickstarts,omitempty" yaml:"quickstarts"` File string `json:"file" yaml:"file"` InstallTargets []OpenInstallationRecipeInstallTarget `json:"installTargets" yaml:"installTargets"` Keywords []string `json:"keywords" yaml:"keywords"` LogMatch []LogMatch `json:"logMatch" yaml:"logMatch"` Name string `json:"name" yaml:"name"` PreInstall OpenInstallationPreInstallConfiguration `json:"preInstall" yaml:"preInstall"` PostInstall OpenInstallationPostInstallConfiguration `json:"postInstall" yaml:"postInstall"` ProcessMatch []string `json:"processMatch" yaml:"processMatch"` Repository string `json:"repository" yaml:"repository"` SuccessLinkConfig OpenInstallationSuccessLinkConfig `json:"successLinkConfig" yaml:"successLinkConfig"` ValidationNRQL string `json:"validationNrql" yaml:"validationNrql"` Vars map[string]interface{} }
func (*Recipe) AddVar ¶
AddVar is responsible for including a new variable on the recipe Vars struct, which is used by go-task executor.
func (*Recipe) HasApplicationTargetType ¶ added in v0.18.29
func (*Recipe) HasHostTargetType ¶ added in v0.18.29
func (*Recipe) HasKeyword ¶ added in v0.22.0
func (*Recipe) HasTargetType ¶ added in v0.18.29
func (r *Recipe) HasTargetType(t OpenInstallationTargetType) bool