elasticsearch

Documentation

Index

• Constants
• func ConfigAdd(path string)
• func NewBulkIndexer(ctx context.Context, client *elasticsearch.Client) (esutil.BulkIndexer, error)
• func NewBulkIndexerWithConfigPath(ctx context.Context, path string, client *elasticsearch.Client) (esutil.BulkIndexer, error)
• func NewBulkIndexerWithOptions(ctx context.Context, options *BulkOptions, client *elasticsearch.Client) (bi esutil.BulkIndexer, err error)
• func NewClient(ctx context.Context, plugins ...Plugin) (*elasticsearch.Client, error)
• func NewClientWithConfigPath(ctx context.Context, path string, plugins ...Plugin) (*elasticsearch.Client, error)
• func NewClientWithOptions(ctx context.Context, o *Options, plugins ...Plugin) (client *elasticsearch.Client, err error)
• type BulkOptions
  • func NewBulkOptions() (*BulkOptions, error)
  • func NewBulkOptionsWithPath(path string) (opts *BulkOptions, err error)
• type DebugLogger
  • func (l *DebugLogger) Printf(msg string, args ...interface{})
• type Logger
  • func (l *Logger) LogRoundTrip(req *http.Request, res *http.Response, err error, start time.Time, ...) error
  • func (l *Logger) RequestBodyEnabled() bool
  • func (l *Logger) ResponseBodyEnabled() bool
• type ManagedClient
  • func NewManagedClient(ctx context.Context, plugins ...Plugin) (*ManagedClient, error)
  • func NewManagedClientWithConfigPath(ctx context.Context, path string, plugins ...Plugin) (*ManagedClient, error)
  • func NewManagedClientWithOptions(ctx context.Context, opts *Options, plugins ...Plugin) (*ManagedClient, error)
• type Options
  • func NewOptions() (*Options, error)
  • func NewOptionsWithPath(path string) (opts *Options, err error)
• type Plugin

Constants

const (
	PluginsRoot = root + ".plugins"
)

Functions

func ConfigAdd

func ConfigAdd(path string)

func NewBulkIndexer

func NewBulkIndexer(ctx context.Context, client *elasticsearch.Client) (esutil.BulkIndexer, error)

NewBulkIndexer returns elasticsearch bulk indexer with default options.

func NewBulkIndexerWithConfigPath

func NewBulkIndexerWithConfigPath(ctx context.Context, path string, client *elasticsearch.Client) (esutil.BulkIndexer, error)

NewBulkIndexerWithConfigPath returns elasticsearch bulk indexer with options from config path.

func NewBulkIndexerWithOptions

func NewBulkIndexerWithOptions(ctx context.Context, options *BulkOptions, client *elasticsearch.Client) (bi esutil.BulkIndexer, err error)

NewBulkIndexerWithOptions returns elasticsearch bulk indexer with options.

func NewClient

func NewClient(ctx context.Context, plugins ...Plugin) (*elasticsearch.Client, error)

NewClient returns elasticsearch client with default options.

func NewClientWithConfigPath

func NewClientWithConfigPath(ctx context.Context, path string, plugins ...Plugin) (*elasticsearch.Client, error)

NewClientWithConfigPath returns elasticsearch client with options from config path.

func NewClientWithOptions

func NewClientWithOptions(ctx context.Context, o *Options, plugins ...Plugin) (client *elasticsearch.Client, err error)

NewClientWithOptions returns elasticsearch client with options.

Types

type BulkOptions

type BulkOptions struct {
	NumWorkers    int
	FlushInterval time.Duration
	FlushBytes    int
	Pipeline      string
	Timeout       time.Duration
	Index         string
}

func NewBulkOptions

func NewBulkOptions() (*BulkOptions, error)

NewBulkOptions returns options from config file or environment vars.

func NewBulkOptionsWithPath

func NewBulkOptionsWithPath(path string) (opts *BulkOptions, err error)

NewBulkOptionsWithPath unmarshals a given key path into options and returns it.

type DebugLogger

type DebugLogger struct {
}

func (*DebugLogger) Printf

func (l *DebugLogger) Printf(msg string, args ...interface{})

type Logger

type Logger struct {
}

Logger implements the estransport.Logger interface.

func (*Logger) LogRoundTrip

func (l *Logger) LogRoundTrip(
	req *http.Request,
	res *http.Response,
	err error,
	start time.Time,
	dur time.Duration,
) error

LogRoundTrip prints the information about request and response.

func (*Logger) RequestBodyEnabled

func (l *Logger) RequestBodyEnabled() bool

RequestBodyEnabled makes the client pass request body to logger.

func (*Logger) ResponseBodyEnabled

func (l *Logger) ResponseBodyEnabled() bool

RequestBodyEnabled makes the client pass response body to logger.

type ManagedClient

type ManagedClient struct {
	Client  *elasticsearch.Client
	Plugins []Plugin
	Options *Options
}

ManagedClient struct that represents a managed client.

func NewManagedClient

func NewManagedClient(ctx context.Context, plugins ...Plugin) (*ManagedClient, error)

NewManagedClient returns a managed client with default options.

func NewManagedClientWithConfigPath

func NewManagedClientWithConfigPath(ctx context.Context, path string, plugins ...Plugin) (*ManagedClient, error)

NewManagedClientWithConfigPath returns a managed client with options from config path.

func NewManagedClientWithOptions

func NewManagedClientWithOptions(ctx context.Context, opts *Options, plugins ...Plugin) (*ManagedClient, error)

NewManagedClientWithOptions returns a managed client with options.

type Options

type Options struct {
	Addresses             []string
	Username              string
	Password              string
	CloudID               string `config:"cloudID"`
	APIKey                string `config:"APIKey"`
	CACert                string `config:"CACert"`
	RetryOnStatus         []int
	DisableRetry          bool
	EnableRetryOnTimeout  bool
	MaxRetries            int
	DiscoverNodesOnStart  bool
	DiscoverNodesInterval time.Duration
	EnableMetrics         bool
	EnableDebugLogger     bool
	RetryBackoff          time.Duration
}

func NewOptions

func NewOptions() (*Options, error)

NewOptions returns options from config file or environment vars.

func NewOptionsWithPath

func NewOptionsWithPath(path string) (opts *Options, err error)

NewOptionsWithPath unmarshals a given key path into options and returns it.

type Plugin

type Plugin func(context.Context, *elasticsearch.Client) error

Plugin defines a function to process plugin.