entities

Documentation

Index

• Variables
• type ApmApplicationEntity
• type ApmApplicationEntityOutlineRunningAgentVersions
• type ApmApplicationEntityOutlineSettings
• type BrowserApplicationEntity
• type Entities
  • func New(config config.Config) Entities
  • func (e *Entities) AddTags(guid string, tags []Tag) error
  • func (e *Entities) DeleteTagValues(guid string, tagValues []TagValue) error
  • func (e *Entities) DeleteTags(guid string, tagKeys []string) error
  • func (e *Entities) GetEntities(guids []string) ([]*Entity, error)
  • func (e *Entities) GetEntity(guid string) (*Entity, error)
  • func (e *Entities) ListTags(guid string) ([]*Tag, error)
  • func (e *Entities) ReplaceTags(guid string, tags []Tag) error
  • func (e *Entities) SearchEntities(params SearchEntitiesParams) ([]*Entity, error)
• type Entity
• type EntityAlertSeverityType
• type EntityDomainType
• type EntityType
• type SearchEntitiesParams
• type Tag
• type TagValue
• type Type

Variables

var BaseURLs = region.NerdGraphBaseURLs

BaseURLs represents the base API URLs for the different environments of the New Relic REST API V2.

var (
	// EntityAlertSeverities specifies the possible alert severities for a New Relic One entity.
	EntityAlertSeverities = struct {
		Critical      EntityAlertSeverityType
		NotAlerting   EntityAlertSeverityType
		NotConfigured EntityAlertSeverityType
		Warning       EntityAlertSeverityType
	}{
		Critical:      "CRITICAL",
		NotAlerting:   "NOT_ALERTING",
		NotConfigured: "NOT_CONFIGURED",
		Warning:       "WARNING",
	}
)

var (
	// EntityDomains specifies the possible domains for a New Relic One entity.
	EntityDomains = struct {
		APM            EntityDomainType
		Browser        EntityDomainType
		Infrastructure EntityDomainType
		Mobile         EntityDomainType
		Nr1            EntityDomainType
		Synthetics     EntityDomainType
		Visualization  EntityDomainType
	}{
		APM:            "APM",
		Browser:        "BROWSER",
		Infrastructure: "INFRA",
		Mobile:         "MOBILE",
		Nr1:            "NR1",
		Synthetics:     "SYNTH",
		Visualization:  "VIZ",
	}
)

var (
	// EntityTypes specifies the possible types for a New Relic One entity.
	EntityTypes = struct {
		Application EntityType
		Browser     EntityType
		Dashboard   EntityType
		Host        EntityType
		Mobile      EntityType
		Monitor     EntityType
		Workload    EntityType
	}{
		Application: "APM_APPLICATION_ENTITY",
		Browser:     "BROWSER_APPLICATION_ENTITY",
		Dashboard:   "DASHBOARD_ENTITY",
		Host:        "INFRASTRUCTURE_HOST_ENTITY",
		Mobile:      "MOBILE_APPLICATION_ENTITY",
		Monitor:     "SYNTHETIC_MONITOR_ENTITY",
		Workload:    "WORKLOAD_ENTITY",
	}
)

var (
	// Types specifies the possible types for a New Relic One entity.
	Types = struct {
		Application Type
		Dashboard   Type
		Host        Type
		Monitor     Type
		Workload    Type
	}{
		Application: "APPLICATION",
		Dashboard:   "DASHBOARD",
		Host:        "HOST",
		Monitor:     "MONITOR",
		Workload:    "WORKLOAD",
	}
)

Types

type ApmApplicationEntity

type ApmApplicationEntity struct {
	Language             *string                                          `json:"language,omitempty"`
	RunningAgentVersions *ApmApplicationEntityOutlineRunningAgentVersions `json:"runningAgentVersions,omitempty"`
	Settings             *ApmApplicationEntityOutlineSettings             `json:"settings,omitempty"`
}

ApmApplicationEntity represents the unique fields returned on the ApmApplicationEntity interface

type ApmApplicationEntityOutlineRunningAgentVersions

type ApmApplicationEntityOutlineRunningAgentVersions struct {
	MaxVersion *string `json:"maxVersion,omitempty"`
	MinVersion *string `json:"minVersion,omitempty"`
}

type ApmApplicationEntityOutlineSettings

type ApmApplicationEntityOutlineSettings struct {
	ApdexTarget      *float64 `json:"apdexTarget,omitempty"`
	ServerSideConfig *bool    `json:"serverSideConfig"`
}

type BrowserApplicationEntity

type BrowserApplicationEntity struct {
	ServingApmApplicationID *int `json:"servingApmApplicationId,omitempty"`
}

BrowserApplicationEntity represents the unique fields returned on the BrowserApplicationEntity interface

type Entities

type Entities struct {
	// contains filtered or unexported fields
}

Entities is used to communicate with the New Relic Entities product.

func New

func New(config config.Config) Entities

New returns a new client for interacting with New Relic One entities.

func (*Entities) AddTags

func (e *Entities) AddTags(guid string, tags []Tag) error

AddTags writes tags to the entity specified by the provided entity GUID.

func (*Entities) DeleteTagValues

func (e *Entities) DeleteTagValues(guid string, tagValues []TagValue) error

DeleteTagValues deletes specific tag key and value pairs from the entity.

func (*Entities) DeleteTags

func (e *Entities) DeleteTags(guid string, tagKeys []string) error

DeleteTags deletes specific tag keys from the entity.

func (*Entities) GetEntities

func (e *Entities) GetEntities(guids []string) ([]*Entity, error)

GetEntities retrieves a set of New Relic One entities by their entity guids.

func (*Entities) GetEntity

func (e *Entities) GetEntity(guid string) (*Entity, error)

GetEntity retrieve a set of New Relic One entities by their entity guids.

func (*Entities) ListTags

func (e *Entities) ListTags(guid string) ([]*Tag, error)

ListTags returns a collection of tags for a given entity by entity GUID.

func (*Entities) ReplaceTags

func (e *Entities) ReplaceTags(guid string, tags []Tag) error

ReplaceTags replaces the entity's entire set of tags with the provided tag set.

func (*Entities) SearchEntities

func (e *Entities) SearchEntities(params SearchEntitiesParams) ([]*Entity, error)

SearchEntities searches New Relic One entities based on the provided search parameters.

type Entity

type Entity struct {
	AccountID  int              `json:"accountId,omitempty"`
	Domain     EntityDomainType `json:"domain,omitempty"`
	EntityType EntityType       `json:"entityType,omitempty"` // Full Type (ie APM_APPLICATION_ENTITY)
	GUID       string           `json:"guid,omitempty"`
	Name       string           `json:"name,omitempty"`
	Permalink  string           `json:"permalink,omitempty"`
	Reporting  bool             `json:"reporting,omitempty"`
	Type       Type             `json:"type,omitempty"`

	// ApmApplicationEntity, BrowserApplicationEntity
	AlertSeverity *EntityAlertSeverityType `json:"alertSeverity,omitempty"`
	ApplicationID *int                     `json:"applicationId,omitempty"`

	// Stitch in other structs
	ApmApplicationEntity
	BrowserApplicationEntity
}

Entity represents a New Relic One entity.

type EntityAlertSeverityType

type EntityAlertSeverityType string

EntityAlertSeverityType represents a New Relic One entity alert severity.

type EntityDomainType

type EntityDomainType string

EntityDomainType represents a New Relic One entity domain.

type EntityType

type EntityType string

EntityType represents a New Relic One entity type (full)

type SearchEntitiesParams

type SearchEntitiesParams struct {
	AlertSeverity                 EntityAlertSeverityType `json:"alertSeverity,omitempty"`
	Domain                        EntityDomainType        `json:"domain,omitempty"`
	InfrastructureIntegrationType string                  `json:"infrastructureIntegrationType,omitempty"`
	Name                          string                  `json:"name,omitempty"`
	Reporting                     *bool                   `json:"reporting,omitempty"`
	Tags                          *TagValue               `json:"tags,omitempty"`
	Type                          EntityType              `json:"type,omitempty"`
}

SearchEntitiesParams represents a set of search parameters for retrieving New Relic One entities.

type Tag

type Tag struct {
	Key    string
	Values []string
}

Tag represents a New Relic One entity tag.

type TagValue

type TagValue struct {
	Key   string
	Value string
}

TagValue represents a New Relic One entity tag and value pair.

type Type

type Type string

Type represents a New Relic One entity type (short)