ec2

Documentation

Index

• Variables
• func GetClusterName() (string, error)
• func GetHostname() (string, error)
• func GetInstanceID() (string, error)
• func GetLocalIPv4() ([]string, error)
• func GetNTPHosts() []string
• func GetNetworkID() (string, error)
• func GetPublicIPv4() (string, error)
• func GetTags() ([]string, error)
• func HostnameProvider() (string, error)
• func IsDefaultHostname(hostname string) bool
• func IsDefaultHostnameForIntake(hostname string) bool
• func IsRunningOn() bool
• func IsWindowsDefaultHostname(hostname string) bool
• type Subnet
  • func GetSubnetForHardwareAddr(hwAddr net.HardwareAddr) (subnet Subnet, err error)

Variables

var (

	// CloudProviderName contains the inventory name of for EC2
	CloudProviderName = "AWS"
)

declare these as vars not const to ease testing

Functions

func GetClusterName

func GetClusterName() (string, error)

GetClusterName returns the name of the cluster containing the current EC2 instance

func GetHostname

func GetHostname() (string, error)

GetHostname fetches the hostname for current host from the EC2 metadata API

func GetInstanceID

func GetInstanceID() (string, error)

GetInstanceID fetches the instance id for current host from the EC2 metadata API

func GetLocalIPv4

func GetLocalIPv4() ([]string, error)

GetLocalIPv4 gets the local IPv4 for the currently running host using the EC2 metadata API. Returns a []string to implement the HostIPProvider interface expected in pkg/process/util

func GetNTPHosts

func GetNTPHosts() []string

GetNTPHosts returns the NTP hosts for EC2 if it is detected as the cloud provider, otherwise an empty array. Docs: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html#configure_ntp

func GetNetworkID

func GetNetworkID() (string, error)

GetNetworkID retrieves the network ID using the EC2 metadata endpoint. For EC2 instances, the the network ID is the VPC ID, if the instance is found to be a part of exactly one VPC.

func GetPublicIPv4

func GetPublicIPv4() (string, error)

GetPublicIPv4 gets the public IPv4 for the currently running host using the EC2 metadata API.

func GetTags

func GetTags() ([]string, error)

GetTags grabs the host tags from the EC2 api

func HostnameProvider

func HostnameProvider() (string, error)

HostnameProvider gets the hostname

func IsDefaultHostname

func IsDefaultHostname(hostname string) bool

IsDefaultHostname returns whether the given hostname is a default one for EC2

func IsDefaultHostnameForIntake

func IsDefaultHostnameForIntake(hostname string) bool

IsDefaultHostnameForIntake returns whether the given hostname is a default one for EC2 for the intake

func IsRunningOn

func IsRunningOn() bool

IsRunningOn returns true if the agent is running on AWS

func IsWindowsDefaultHostname

func IsWindowsDefaultHostname(hostname string) bool

IsWindowsDefaultHostname returns whether the given hostname is a Windows default one for EC2 (starts with 'ec2amaz-')

Types

type Subnet

type Subnet struct {
	ID   string
	Cidr string
}

Subnet stores information about an AWS subnet

func GetSubnetForHardwareAddr

func GetSubnetForHardwareAddr(hwAddr net.HardwareAddr) (subnet Subnet, err error)

GetSubnetForHardwareAddr returns info about the subnet associated with a hardware address (mac address) on the current host