Package v1alpha1 contains API Schema definitions for the agent v1alpha1 API group
Agent is the Schema for the Agents API.
| Field | Description |
|---|---|
|
|
|
|
|
Refer to Kubernetes API documentation for fields of |
|
AgentSpec defines the desired state of the Agent
| Field | Description |
|---|---|
|
Version of the Agent. |
|
ElasticsearchRefs is a reference to a list of Elasticsearch clusters running in the same Kubernetes cluster. Due to existing limitations, only a single ES cluster is currently supported. |
|
Image is the Agent Docker image to deploy. Version has to match the Agent in the image. |
|
Config holds the Agent configuration. At most one of [ |
|
ConfigRef contains a reference to an existing Kubernetes Secret holding the Agent configuration.
Agent settings must be specified as yaml, under a single "agent.yml" entry. At most one of [ |
|
SecureSettings is a list of references to Kubernetes Secrets containing sensitive configuration options for the Agent.
Secrets data can be then referenced in the Agent config using the Secret’s keys or as specified in |
|
ServiceAccountName is used to check access from the current resource to an Elasticsearch resource in a different namespace. Can only be used if ECK is enforcing RBAC on references. |
|
DaemonSet specifies the Agent should be deployed as a DaemonSet, and allows providing its spec.
Cannot be used along with |
|
Deployment specifies the Agent should be deployed as a Deployment, and allows providing its spec.
Cannot be used along with |
|
StatefulSet specifies the Agent should be deployed as a StatefulSet, and allows providing its spec.
Cannot be used along with |
|
RevisionHistoryLimit is the number of revisions to retain to allow rollback in the underlying DaemonSet or Deployment or StatefulSet. |
|
HTTP holds the HTTP layer configuration for the Agent in Fleet mode with Fleet Server enabled. |
|
Mode specifies the source of configuration for the Agent. The configuration can be specified locally through
|
|
FleetServerEnabled determines whether this Agent will launch Fleet Server. Don’t set unless |
|
PolicyID determines into which Agent Policy this Agent will be enrolled. This field will become mandatory in a future release, default policies are deprecated since 8.1.0. |
|
KibanaRef is a reference to Kibana where Fleet should be set up and this Agent should be enrolled. Don’t set
unless |
|
FleetServerRef is a reference to Fleet Server that this Agent should connect to to obtain it’s configuration.
Don’t set unless |
| Field | Description |
|---|---|
|
|
|
| Field | Description |
|---|---|
|
|
|
|
|
| Field | Description |
|---|---|
|
|
|
|
|
|
|
PodManagementPolicy controls how pods are created during initial scale up,
when replacing pods on nodes, or when scaling down. The default policy is
|
|
VolumeClaimTemplates is a list of persistent volume claims to be used by each Pod. Every claim in this list must have a matching volumeMount in one of the containers defined in the PodTemplate. Items defined here take precedence over any default claims added by the operator with the same name. |
Package v1 contains API schema definitions for managing APM Server resources.
ApmServer represents an APM Server resource in a Kubernetes cluster.
| Field | Description |
|---|---|
|
|
|
|
|
Refer to Kubernetes API documentation for fields of |
|
ApmServerSpec holds the specification of an APM Server.
| Field | Description |
|---|---|
|
Version of the APM Server. |
|
Image is the APM Server Docker image to deploy. |
|
Count of APM Server instances to deploy. |
|
Config holds the APM Server configuration. See: https://www.elastic.co/guide/en/apm/server/current/configuring-howto-apm-server.html |
|
HTTP holds the HTTP layer configuration for the APM Server resource. |
|
ElasticsearchRef is a reference to the output Elasticsearch cluster running in the same Kubernetes cluster. |
|
KibanaRef is a reference to a Kibana instance running in the same Kubernetes cluster. It allows APM agent central configuration management in Kibana. |
|
PodTemplate provides customisation options (labels, annotations, affinity rules, resource requests, and so on) for the APM Server pods. |
|
RevisionHistoryLimit is the number of revisions to retain to allow rollback in the underlying Deployment. |
|
SecureSettings is a list of references to Kubernetes secrets containing sensitive configuration options for APM Server. |
|
ServiceAccountName is used to check access from the current resource to a resource (for ex. Elasticsearch) in a different namespace. Can only be used if ECK is enforcing RBAC on references. |
Package v1beta1 contains API schema definitions for managing APM Server resources.
ApmServer represents an APM Server resource in a Kubernetes cluster.
| Field | Description |
|---|---|
|
|
|
|
|
Refer to Kubernetes API documentation for fields of |
|
ApmServerSpec holds the specification of an APM Server.
| Field | Description |
|---|---|
|
Version of the APM Server. |
|
Image is the APM Server Docker image to deploy. |
|
Count of APM Server instances to deploy. |
|
Config holds the APM Server configuration. See: https://www.elastic.co/guide/en/apm/server/current/configuring-howto-apm-server.html |
|
HTTP holds the HTTP layer configuration for the APM Server resource. |
|
ElasticsearchRef is a reference to the output Elasticsearch cluster running in the same Kubernetes cluster. |
|
PodTemplate provides customisation options (labels, annotations, affinity rules, resource requests, and so on) for the APM Server pods. |
|
SecureSettings is a list of references to Kubernetes secrets containing sensitive configuration options for APM Server. |
Package v1alpha1 contains API schema definitions for managing ElasticsearchAutoscaler resources.
ElasticsearchAutoscaler represents an ElasticsearchAutoscaler resource in a Kubernetes cluster.
| Field | Description |
|---|---|
|
|
|
|
|
Refer to Kubernetes API documentation for fields of |
ElasticsearchAutoscalerSpec holds the specification of an Elasticsearch autoscaler resource.
| Field | Description |
|---|---|
|
|
|
PollingPeriod is the period at which to synchronize with the Elasticsearch autoscaling API. |
ElasticsearchRef is a reference to an Elasticsearch cluster that exists in the same namespace.
| Field | Description |
|---|---|
|
Name is the name of the Elasticsearch resource to scale automatically. |
Package v1beta1 contains API Schema definitions for the beat v1beta1 API group
Beat is the Schema for the Beats API.
| Field | Description |
|---|---|
|
|
|
|
|
Refer to Kubernetes API documentation for fields of |
|
BeatSpec defines the desired state of a Beat.
| Field | Description |
|---|---|
|
Type is the type of the Beat to deploy (filebeat, metricbeat, heartbeat, auditbeat, journalbeat, packetbeat, and so on).
Any string can be used, but well-known types will have the image field defaulted and have the appropriate
Elasticsearch roles created automatically. It also allows for dashboard setup when combined with a |
|
Version of the Beat. |
|
ElasticsearchRef is a reference to an Elasticsearch cluster running in the same Kubernetes cluster. |
|
KibanaRef is a reference to a Kibana instance running in the same Kubernetes cluster. It allows automatic setup of dashboards and visualizations. |
|
Image is the Beat Docker image to deploy. Version and Type have to match the Beat in the image. |
|
Config holds the Beat configuration. At most one of [ |
|
ConfigRef contains a reference to an existing Kubernetes Secret holding the Beat configuration.
Beat settings must be specified as yaml, under a single "beat.yml" entry. At most one of [ |
|
SecureSettings is a list of references to Kubernetes Secrets containing sensitive configuration options for the Beat.
Secrets data can be then referenced in the Beat config using the Secret’s keys or as specified in |
|
ServiceAccountName is used to check access from the current resource to Elasticsearch resource in a different namespace. Can only be used if ECK is enforcing RBAC on references. |
|
DaemonSet specifies the Beat should be deployed as a DaemonSet, and allows providing its spec.
Cannot be used along with |
|
Deployment specifies the Beat should be deployed as a Deployment, and allows providing its spec.
Cannot be used along with |
|
Monitoring enables you to collect and ship logs and metrics for this Beat. Metricbeat and/or Filebeat sidecars are configured and send monitoring data to an Elasticsearch monitoring cluster running in the same Kubernetes cluster. |
|
RevisionHistoryLimit is the number of revisions to retain to allow rollback in the underlying DaemonSet or Deployment. |
| Field | Description |
|---|---|
|
|
|
| Field | Description |
|---|---|
|
|
|
|
|
Package v1 contains API schema definitions for common types used by all resources.
Config represents untyped YAML configuration.
ConfigMapRef is a reference to a config map that exists in the same namespace as the referring resource.
| Field | Description |
|---|---|
|
ConfigSource references configuration settings.
| Field | Description |
|---|---|
|
SecretName is the name of the secret. |
HTTPConfig holds the HTTP layer configuration for resources.
| Field | Description |
|---|---|
|
Service defines the template for the associated Kubernetes Service object. |
|
TLS defines options for configuring TLS for HTTP. |
KeyToPath defines how to map a key in a Secret object to a filesystem path.
| Field | Description |
|---|---|
|
Key is the key contained in the secret. |
|
Path is the relative file path to map the key to. Path must not be an absolute file path and must not contain any ".." components. |
LocalObjectSelector defines a reference to a Kubernetes object corresponding to an Elastic resource managed by the operator
| Field | Description |
|---|---|
|
Namespace of the Kubernetes object. If empty, defaults to the current namespace. |
|
Name of an existing Kubernetes object corresponding to an Elastic resource managed by ECK. |
|
ServiceName is the name of an existing Kubernetes service which is used to make requests to the referenced object. It has to be in the same namespace as the referenced resource. If left empty, the default HTTP service of the referenced resource is used. |
LogsMonitoring holds a list of Elasticsearch clusters which receive logs data from associated resources.
| Field | Description |
|---|---|
|
ElasticsearchRefs is a reference to a list of monitoring Elasticsearch clusters running in the same Kubernetes cluster. Due to existing limitations, only a single Elasticsearch cluster is currently supported. |
MetricsMonitoring holds a list of Elasticsearch clusters which receive monitoring data from associated resources.
| Field | Description |
|---|---|
|
ElasticsearchRefs is a reference to a list of monitoring Elasticsearch clusters running in the same Kubernetes cluster. Due to existing limitations, only a single Elasticsearch cluster is currently supported. |
Monitoring holds references to both the metrics, and logs Elasticsearch clusters for configuring stack monitoring.
| Field | Description |
|---|---|
|
Metrics holds references to Elasticsearch clusters which receive monitoring data from this resource. |
|
Logs holds references to Elasticsearch clusters which receive log data from an associated resource. |
ObjectSelector defines a reference to a Kubernetes object which can be an Elastic resource managed by the operator or a Secret describing an external Elastic resource not managed by the operator.
| Field | Description |
|---|---|
|
Namespace of the Kubernetes object. If empty, defaults to the current namespace. |
|
Name of an existing Kubernetes object corresponding to an Elastic resource managed by ECK. |
|
ServiceName is the name of an existing Kubernetes service which is used to make requests to the referenced object. It has to be in the same namespace as the referenced resource. If left empty, the default HTTP service of the referenced resource is used. |
|
SecretName is the name of an existing Kubernetes secret that contains connection information for associating an
Elastic resource not managed by the operator. The referenced secret must contain the following:
- |
PodDisruptionBudgetTemplate defines the template for creating a PodDisruptionBudget.
| Field | Description |
|---|---|
|
Refer to Kubernetes API documentation for fields of |
Spec is the specification of the PDB. |
SecretRef is a reference to a secret that exists in the same namespace.
| Field | Description |
|---|---|
|
SecretName is the name of the secret. |
SecretSource defines a data source based on a Kubernetes Secret.
| Field | Description |
|---|---|
|
SecretName is the name of the secret. |
|
Entries define how to project each key-value pair in the secret to filesystem paths. If not defined, all keys will be projected to similarly named paths in the filesystem. If defined, only the specified keys will be projected to the corresponding paths. |
SelfSignedCertificate holds configuration for the self-signed certificate generated by the operator.
| Field | Description |
|---|---|
|
SubjectAlternativeNames is a list of SANs to include in the generated HTTP TLS certificate. |
|
Disabled indicates that the provisioning of the self-signed certifcate should be disabled. |
ServiceTemplate defines the template for a Kubernetes Service.
| Field | Description |
|---|---|
|
Refer to Kubernetes API documentation for fields of |
|
Spec is the specification of the service. |
SubjectAlternativeName represents a SAN entry in a x509 certificate.
| Field | Description |
|---|---|
|
DNS is the DNS name of the subject. |
|
IP is the IP address of the subject. |
TLSOptions holds TLS configuration options.
| Field | Description |
|---|---|
|
SelfSignedCertificate allows configuring the self-signed certificate generated by the operator. |
|
Certificate is a reference to a Kubernetes secret that contains the certificate and private key for enabling TLS. The referenced secret should contain the following:
|
Package v1alpha1 contains API schema definitions for common types used by all resources.
Condition represents Elasticsearch resource’s condition. This API is in technical preview and may be changed or removed in a future release.
| Field | Description |
|---|---|
|
|
|
|
|
|
|
ConditionType defines the condition of an Elasticsearch resource.
Conditions (Condition)
| Field | Description |
|---|---|
|
|
|
|
|
|
|
Package v1beta1 contains API schema definitions for common types used by all resources.
HTTPConfig holds the HTTP layer configuration for resources.
| Field | Description |
|---|---|
|
Service defines the template for the associated Kubernetes Service object. |
|
TLS defines options for configuring TLS for HTTP. |
KeyToPath defines how to map a key in a Secret object to a filesystem path.
| Field | Description |
|---|---|
|
Key is the key contained in the secret. |
|
Path is the relative file path to map the key to. Path must not be an absolute file path and must not contain any ".." components. |
ObjectSelector defines a reference to a Kubernetes object.
| Field | Description |
|---|---|
|
Name of the Kubernetes object. |
|
Namespace of the Kubernetes object. If empty, defaults to the current namespace. |
PodDisruptionBudgetTemplate defines the template for creating a PodDisruptionBudget.
| Field | Description |
|---|---|
|
Refer to Kubernetes API documentation for fields of |
Spec is the specification of the PDB. |
SecretRef is a reference to a secret that exists in the same namespace.
| Field | Description |
|---|---|
|
SecretName is the name of the secret. |
SecretSource defines a data source based on a Kubernetes Secret.
| Field | Description |
|---|---|
|
SecretName is the name of the secret. |
|
Entries define how to project each key-value pair in the secret to filesystem paths. If not defined, all keys will be projected to similarly named paths in the filesystem. If defined, only the specified keys will be projected to the corresponding paths. |
SelfSignedCertificate holds configuration for the self-signed certificate generated by the operator.
| Field | Description |
|---|---|
|
SubjectAlternativeNames is a list of SANs to include in the generated HTTP TLS certificate. |
|
Disabled indicates that the provisioning of the self-signed certifcate should be disabled. |
ServiceTemplate defines the template for a Kubernetes Service.
| Field | Description |
|---|---|
|
Refer to Kubernetes API documentation for fields of |
|
Spec is the specification of the service. |
SubjectAlternativeName represents a SAN entry in a x509 certificate.
| Field | Description |
|---|---|
|
DNS is the DNS name of the subject. |
|
IP is the IP address of the subject. |
TLSOptions holds TLS configuration options.
| Field | Description |
|---|---|
|
SelfSignedCertificate allows configuring the self-signed certificate generated by the operator. |
|
Certificate is a reference to a Kubernetes secret that contains the certificate and private key for enabling TLS. The referenced secret should contain the following:
|
Package v1 contains API schema definitions for managing Elasticsearch resources.
Auth contains user authentication and authorization security settings for Elasticsearch.
| Field | Description |
|---|---|
|
Roles to propagate to the Elasticsearch cluster. |
|
FileRealm to propagate to the Elasticsearch cluster. |
|
DisableElasticUser disables the default elastic user that is created by ECK. |
ChangeBudget defines the constraints to consider when applying changes to the Elasticsearch cluster.
| Field | Description |
|---|---|
|
MaxUnavailable is the maximum number of Pods that can be unavailable (not ready) during the update due to circumstances under the control of the operator. Setting a negative value will disable this restriction. Defaults to 1 if not specified. |
|
MaxSurge is the maximum number of new Pods that can be created exceeding the original number of Pods defined in the specification. MaxSurge is only taken into consideration when scaling up. Setting a negative value will disable the restriction. Defaults to unbounded if not specified. |
DownscaleOperation provides details about in progress downscale operations. This API is in technical preview and may be changed or removed in a future release.
| Field | Description |
|---|---|
|
|
|
Nodes which are scheduled to be removed from the cluster. |
|
Stalled represents a state where no progress can be made. It is only available for clusters managed with the Elasticsearch shutdown API. |
DownscaledNode provides an overview of in progress changes applied by the operator to remove Elasticsearch nodes from the cluster. This API is in technical preview and may be changed or removed in a future release.
| Field | Description |
|---|---|
|
Name of the Elasticsearch node that should be removed. |
|
Shutdown status as returned by the Elasticsearch shutdown API. If the Elasticsearch shutdown API is not available, the shutdown status is then inferred from the remaining shards on the nodes, as observed by the operator. |
|
Explanation provides details about an in progress node shutdown. It is only available for clusters managed with the Elasticsearch shutdown API. |
Elasticsearch represents an Elasticsearch resource in a Kubernetes cluster.
| Field | Description |
|---|---|
|
|
|
|
|
Refer to Kubernetes API documentation for fields of |
|
|
|
ElasticsearchHealth is the health of the cluster as returned by the health API.
ElasticsearchOrchestrationPhase is the phase Elasticsearch is in from the controller point of view.
ElasticsearchSpec holds the specification of an Elasticsearch cluster.
| Field | Description |
|---|---|
|
Version of Elasticsearch. |
|
Image is the Elasticsearch Docker image to deploy. |
|
HTTP holds HTTP layer settings for Elasticsearch. |
|
Transport holds transport layer settings for Elasticsearch. |
|
NodeSets allow specifying groups of Elasticsearch nodes sharing the same configuration and Pod templates. |
|
UpdateStrategy specifies how updates to the cluster should be performed. |
|
PodDisruptionBudget provides access to the default Pod disruption budget for the Elasticsearch cluster.
The default budget doesn’t allow any Pod to be removed in case the cluster is not green or if there is only one node of type |
|
Auth contains user authentication and authorization security settings for Elasticsearch. |
|
SecureSettings is a list of references to Kubernetes secrets containing sensitive configuration options for Elasticsearch. |
|
ServiceAccountName is used to check access from the current resource to a resource (for ex. a remote Elasticsearch cluster) in a different namespace. Can only be used if ECK is enforcing RBAC on references. |
|
RemoteClusters enables you to establish uni-directional connections to a remote Elasticsearch cluster. |
|
VolumeClaimDeletePolicy sets the policy for handling deletion of PersistentVolumeClaims for all NodeSets. Possible values are DeleteOnScaledownOnly and DeleteOnScaledownAndClusterDeletion. Defaults to DeleteOnScaledownAndClusterDeletion. |
|
Monitoring enables you to collect and ship log and monitoring data of this Elasticsearch cluster. See https://www.elastic.co/guide/en/elasticsearch/reference/current/monitor-elasticsearch-cluster.html. Metricbeat and Filebeat are deployed in the same Pod as sidecars and each one sends data to one or two different Elasticsearch monitoring clusters running in the same Kubernetes cluster. |
|
RevisionHistoryLimit is the number of revisions to retain to allow rollback in the underlying StatefulSets. |
ElasticsearchStatus represents the observed state of Elasticsearch.
| Field | Description |
|---|---|
|
AvailableNodes is the number of available instances. |
|
Version of the stack resource currently running. During version upgrades, multiple versions may run in parallel: this value specifies the lowest version currently running. |
|
|
|
Conditions holds the current service state of an Elasticsearch cluster. This API is in technical preview and may be changed or removed in a future release. |
|
InProgressOperations represents changes being applied by the operator to the Elasticsearch cluster. This API is in technical preview and may be changed or removed in a future release. |
|
ObservedGeneration is the most recent generation observed for this Elasticsearch cluster. It corresponds to the metadata generation, which is updated on mutation by the API Server. If the generation observed in status diverges from the generation in metadata, the Elasticsearch controller has not yet processed the changes contained in the Elasticsearch specification. |
FileRealmSource references users to create in the Elasticsearch cluster.
| Field | Description |
|---|---|
|
SecretName is the name of the secret. |
InProgressOperations provides details about in progress changes applied by the operator on the Elasticsearch cluster. This API is in technical preview and may be changed or removed in a future release.
| Field | Description |
|---|---|
|
|
|
|
|
| Field | Description |
|---|---|
|
Name of the Elasticsearch node that should be added to the cluster. |
|
NewNodeStatus states if a new node is being created, or if the upscale is delayed. |
|
Optional message to explain why a node may not be immediately added. |
NewNodeStatus provides details about the status of nodes which are expected to be created and added to the Elasticsearch cluster. This API is in technical preview and may be changed or removed in a future release.
NodeSet is the specification for a group of Elasticsearch nodes sharing the same configuration and a Pod template.
| Field | Description |
|---|---|
|
Name of this set of nodes. Becomes a part of the Elasticsearch node.name setting. |
|
Config holds the Elasticsearch configuration. |
|
Count of Elasticsearch nodes to deploy. If the node set is managed by an autoscaling policy the initial value is automatically set by the autoscaling controller. |
|
PodTemplate provides customisation options (labels, annotations, affinity rules, resource requests, and so on) for the Pods belonging to this NodeSet. |
|
VolumeClaimTemplates is a list of persistent volume claims to be used by each Pod in this NodeSet. Every claim in this list must have a matching volumeMount in one of the containers defined in the PodTemplate. Items defined here take precedence over any default claims added by the operator with the same name. |
RemoteCluster declares a remote Elasticsearch cluster connection.
| Field | Description |
|---|---|
|
Name is the name of the remote cluster as it is set in the Elasticsearch settings. The name is expected to be unique for each remote clusters. |
|
ElasticsearchRef is a reference to an Elasticsearch cluster running within the same k8s cluster. |
RoleSource references roles to create in the Elasticsearch cluster.
| Field | Description |
|---|---|
|
SecretName is the name of the secret. |
SelfSignedTransportCertificates holds configuration for the self-signed certificates generated by the operator.
| Field | Description |
|---|---|
|
Disabled indicates that provisioning of the self-signed certificates should be disabled. |
TransportConfig holds the transport layer settings for Elasticsearch.
| Field | Description |
|---|---|
|
Service defines the template for the associated Kubernetes Service object. |
TLS defines options for configuring TLS on the transport layer. |
| Field | Description |
|---|---|
|
OtherNameSuffix when defined will be prefixed with the Pod name and used as the common name, and the first DNSName, as well as an OtherName required by Elasticsearch in the Subject Alternative Name extension of each Elasticsearch node’s transport TLS certificate. Example: if set to "node.cluster.local", the generated certificate will have its otherName set to "<pod_name>.node.cluster.local". |
|
SubjectAlternativeNames is a list of SANs to include in the generated node transport TLS certificates. |
|
Certificate is a reference to a Kubernetes secret that contains the CA certificate and private key for generating node certificates. The referenced secret should contain the following:
|
|
CertificateAuthorities is a reference to a config map that contains one or more x509 certificates for
trusted authorities in PEM format. The certificates need to be in a file called |
|
SelfSignedCertificates allows configuring the self-signed certificate generated by the operator. |
UpdateStrategy specifies how updates to the cluster should be performed.
| Field | Description |
|---|---|
|
ChangeBudget defines the constraints to consider when applying changes to the Elasticsearch cluster. |
UpgradeOperation provides an overview of the pending or in progress changes applied by the operator to update the Elasticsearch nodes in the cluster. This API is in technical preview and may be changed or removed in a future release.
| Field | Description |
|---|---|
|
|
|
Nodes that must be restarted for upgrade. |
UpgradedNode provides details about the status of nodes which are expected to be updated. This API is in technical preview and may be changed or removed in a future release.
| Field | Description |
|---|---|
|
Name of the Elasticsearch node that should be upgraded. |
|
Status states if the node is either in the process of being deleted for an upgrade, or blocked by a predicate or another condition stated in the message field. |
|
Optional message to explain why a node may not be immediately restarted for upgrade. |
|
Predicate is the name of the predicate currently preventing this node from being deleted for an upgrade. |
UpscaleOperation provides an overview of in progress changes applied by the operator to add Elasticsearch nodes to the cluster. This API is in technical preview and may be changed or removed in a future release.
| Field | Description |
|---|---|
|
|
|
Nodes expected to be added by the operator. |
VolumeClaimDeletePolicy describes the delete policy for handling PersistentVolumeClaims that hold Elasticsearch data. Inspired by kubernetes/enhancements#2440
Package v1beta1 contains API schema definitions for managing Elasticsearch resources.
ChangeBudget defines the constraints to consider when applying changes to the Elasticsearch cluster.
| Field | Description |
|---|---|
|
MaxUnavailable is the maximum number of pods that can be unavailable (not ready) during the update due to circumstances under the control of the operator. Setting a negative value will disable this restriction. Defaults to 1 if not specified. |
|
MaxSurge is the maximum number of new pods that can be created exceeding the original number of pods defined in the specification. MaxSurge is only taken into consideration when scaling up. Setting a negative value will disable the restriction. Defaults to unbounded if not specified. |
Elasticsearch represents an Elasticsearch resource in a Kubernetes cluster.
| Field | Description |
|---|---|
|
|
|
|
|
Refer to Kubernetes API documentation for fields of |
|
|
|
ElasticsearchHealth is the health of the cluster as returned by the health API.
ElasticsearchOrchestrationPhase is the phase Elasticsearch is in from the controller point of view.
ElasticsearchSpec holds the specification of an Elasticsearch cluster.
| Field | Description |
|---|---|
|
Version of Elasticsearch. |
|
Image is the Elasticsearch Docker image to deploy. |
|
HTTP holds HTTP layer settings for Elasticsearch. |
|
NodeSets allow specifying groups of Elasticsearch nodes sharing the same configuration and Pod templates. |
|
UpdateStrategy specifies how updates to the cluster should be performed. |
|
PodDisruptionBudget provides access to the default pod disruption budget for the Elasticsearch cluster.
The default budget selects all cluster pods and sets |
|
SecureSettings is a list of references to Kubernetes secrets containing sensitive configuration options for Elasticsearch. |
ElasticsearchStatus defines the observed state of Elasticsearch
| Field | Description |
|---|---|
|
|
NodeSet is the specification for a group of Elasticsearch nodes sharing the same configuration and a Pod template.
| Field | Description |
|---|---|
|
Name of this set of nodes. Becomes a part of the Elasticsearch node.name setting. |
|
Config holds the Elasticsearch configuration. |
|
Count of Elasticsearch nodes to deploy. |
|
PodTemplate provides customisation options (labels, annotations, affinity rules, resource requests, and so on) for the Pods belonging to this NodeSet. |
|
VolumeClaimTemplates is a list of persistent volume claims to be used by each Pod in this NodeSet. Every claim in this list must have a matching volumeMount in one of the containers defined in the PodTemplate. Items defined here take precedence over any default claims added by the operator with the same name. |
UpdateStrategy specifies how updates to the cluster should be performed.
| Field | Description |
|---|---|
|
ChangeBudget defines the constraints to consider when applying changes to the Elasticsearch cluster. |
Package v1beta1 contains API schema definitions for managing Enterprise Search resources.
EnterpriseSearch is a Kubernetes CRD to represent Enterprise Search.
| Field | Description |
|---|---|
|
|
|
|
|
Refer to Kubernetes API documentation for fields of |
|
EnterpriseSearchSpec holds the specification of an Enterprise Search resource.
| Field | Description |
|---|---|
|
Version of Enterprise Search. |
|
Image is the Enterprise Search Docker image to deploy. |
|
Count of Enterprise Search instances to deploy. |
|
Config holds the Enterprise Search configuration. |
|
ConfigRef contains a reference to an existing Kubernetes Secret holding the Enterprise Search configuration.
Configuration settings are merged and have precedence over settings specified in |
|
HTTP holds the HTTP layer configuration for Enterprise Search resource. |
|
ElasticsearchRef is a reference to the Elasticsearch cluster running in the same Kubernetes cluster. |
|
PodTemplate provides customisation options (labels, annotations, affinity rules, resource requests, and so on) for the Enterprise Search pods. |
|
RevisionHistoryLimit is the number of revisions to retain to allow rollback in the underlying Deployment. |
|
ServiceAccountName is used to check access from the current resource to a resource (for ex. Elasticsearch) in a different namespace. Can only be used if ECK is enforcing RBAC on references. |
Package v1beta1 contains API schema definitions for managing Enterprise Search resources.
EnterpriseSearch is a Kubernetes CRD to represent Enterprise Search.
| Field | Description |
|---|---|
|
|
|
|
|
Refer to Kubernetes API documentation for fields of |
|
EnterpriseSearchSpec holds the specification of an Enterprise Search resource.
| Field | Description |
|---|---|
|
Version of Enterprise Search. |
|
Image is the Enterprise Search Docker image to deploy. |
|
Count of Enterprise Search instances to deploy. |
|
Config holds the Enterprise Search configuration. |
|
ConfigRef contains a reference to an existing Kubernetes Secret holding the Enterprise Search configuration.
Configuration settings are merged and have precedence over settings specified in |
|
HTTP holds the HTTP layer configuration for Enterprise Search resource. |
|
ElasticsearchRef is a reference to the Elasticsearch cluster running in the same Kubernetes cluster. |
|
PodTemplate provides customisation options (labels, annotations, affinity rules, resource requests, and so on) for the Enterprise Search pods. |
|
ServiceAccountName is used to check access from the current resource to a resource (for ex. Elasticsearch) in a different namespace. Can only be used if ECK is enforcing RBAC on references. |
Package v1 contains API schema definitions for managing Kibana resources.
Kibana represents a Kibana resource in a Kubernetes cluster.
| Field | Description |
|---|---|
|
|
|
|
|
Refer to Kubernetes API documentation for fields of |
|
KibanaSpec holds the specification of a Kibana instance.
| Field | Description |
|---|---|
|
Version of Kibana. |
|
Image is the Kibana Docker image to deploy. |
|
Count of Kibana instances to deploy. |
|
ElasticsearchRef is a reference to an Elasticsearch cluster running in the same Kubernetes cluster. |
|
EnterpriseSearchRef is a reference to an EnterpriseSearch running in the same Kubernetes cluster. Kibana provides the default Enterprise Search UI starting version 7.14. |
|
Config holds the Kibana configuration. See: https://www.elastic.co/guide/en/kibana/current/settings.html |
|
HTTP holds the HTTP layer configuration for Kibana. |
|
PodTemplate provides customisation options (labels, annotations, affinity rules, resource requests, and so on) for the Kibana pods |
|
RevisionHistoryLimit is the number of revisions to retain to allow rollback in the underlying Deployment. |
|
SecureSettings is a list of references to Kubernetes secrets containing sensitive configuration options for Kibana. |
|
ServiceAccountName is used to check access from the current resource to a resource (for ex. Elasticsearch) in a different namespace. Can only be used if ECK is enforcing RBAC on references. |
|
Monitoring enables you to collect and ship log and monitoring data of this Kibana. See https://www.elastic.co/guide/en/kibana/current/xpack-monitoring.html. Metricbeat and Filebeat are deployed in the same Pod as sidecars and each one sends data to one or two different Elasticsearch monitoring clusters running in the same Kubernetes cluster. |
Package v1beta1 contains API schema definitions for managing Kibana resources.
Kibana represents a Kibana resource in a Kubernetes cluster.
| Field | Description |
|---|---|
|
|
|
|
|
Refer to Kubernetes API documentation for fields of |
|
KibanaSpec holds the specification of a Kibana instance.
| Field | Description |
|---|---|
|
Version of Kibana. |
|
Image is the Kibana Docker image to deploy. |
|
Count of Kibana instances to deploy. |
|
ElasticsearchRef is a reference to an Elasticsearch cluster running in the same Kubernetes cluster. |
|
Config holds the Kibana configuration. See: https://www.elastic.co/guide/en/kibana/current/settings.html |
|
HTTP holds the HTTP layer configuration for Kibana. |
|
PodTemplate provides customisation options (labels, annotations, affinity rules, resource requests, and so on) for the Kibana pods |
|
SecureSettings is a list of references to Kubernetes secrets containing sensitive configuration options for Kibana. |
Package v1alpha1 contains API Schema definitions for the logstash v1alpha1 API group
ElasticsearchCluster is a named reference to an Elasticsearch cluster which can be used in a Logstash pipeline.
| Field | Description |
|---|---|
|
|
|
ClusterName is an alias for the cluster to be used to refer to the Elasticsearch cluster in Logstash configuration files, and will be used to identify "named clusters" in Logstash |
Logstash is the Schema for the logstashes API
| Field | Description |
|---|---|
|
|
|
|
|
Refer to Kubernetes API documentation for fields of |
|
|
|
| Field | Description |
|---|---|
|
|
|
Service defines the template for the associated Kubernetes Service object. |
|
TLS defines options for configuring TLS for HTTP. |
LogstashSpec defines the desired state of Logstash
| Field | Description |
|---|---|
|
Version of the Logstash. |
|
|
|
Image is the Logstash Docker image to deploy. Version and Type have to match the Logstash in the image. |
|
ElasticsearchRefs are references to Elasticsearch clusters running in the same Kubernetes cluster. |
|
Config holds the Logstash configuration. At most one of [ |
|
ConfigRef contains a reference to an existing Kubernetes Secret holding the Logstash configuration.
Logstash settings must be specified as yaml, under a single "logstash.yml" entry. At most one of [ |
|
Pipelines holds the Logstash Pipelines. At most one of [ |
|
PipelinesRef contains a reference to an existing Kubernetes Secret holding the Logstash Pipelines.
Logstash pipelines must be specified as yaml, under a single "pipelines.yml" entry. At most one of [ |
|
Services contains details of services that Logstash should expose - similar to the HTTP layer configuration for the rest of the stack, but also applicable for more use cases than the metrics API, as logstash may need to be opened up for other services: Beats, TCP, UDP, etc, inputs. |
|
Monitoring enables you to collect and ship log and monitoring data of this Logstash. Metricbeat and Filebeat are deployed in the same Pod as sidecars and each one sends data to one or two different Elasticsearch monitoring clusters running in the same Kubernetes cluster. |
|
PodTemplate provides customisation options for the Logstash pods. |
|
RevisionHistoryLimit is the number of revisions to retain to allow rollback in the underlying StatefulSet. |
|
SecureSettings is a list of references to Kubernetes Secrets containing sensitive configuration options for the Logstash.
Secrets data can be then referenced in the Logstash config using the Secret’s keys or as specified in |
|
ServiceAccountName is used to check access from the current resource to Elasticsearch resource in a different namespace. Can only be used if ECK is enforcing RBAC on references. |
|
UpdateStrategy is a StatefulSetUpdateStrategy. The default type is "RollingUpdate". |
|
VolumeClaimTemplates is a list of persistent volume claims to be used by each Pod. Every claim in this list must have a matching volumeMount in one of the containers defined in the PodTemplate. Items defined here take precedence over any default claims added by the operator with the same name. |
LogstashStatus defines the observed state of Logstash
| Field | Description |
|---|---|
|
Version of the stack resource currently running. During version upgrades, multiple versions may run in parallel: this value specifies the lowest version currently running. |
|
|
|
|
|
|
|
ObservedGeneration is the most recent generation observed for this Logstash instance. It corresponds to the metadata generation, which is updated on mutation by the API Server. If the generation observed in status diverges from the generation in metadata, the Logstash controller has not yet processed the changes contained in the Logstash specification. |
|
Package v1alpha1 contains API schema definitions for managing Elastic Maps Server resources.
ElasticMapsServer represents an Elastic Map Server resource in a Kubernetes cluster.
| Field | Description |
|---|---|
|
|
|
|
|
Refer to Kubernetes API documentation for fields of |
|
ElasticMapsServerList contains a list of ElasticMapsServer
| Field | Description |
|---|---|
|
|
|
|
|
Refer to Kubernetes API documentation for fields of |
|
MapsSpec holds the specification of an Elastic Maps Server instance.
| Field | Description |
|---|---|
|
Version of Elastic Maps Server. |
|
Image is the Elastic Maps Server Docker image to deploy. |
|
Count of Elastic Maps Server instances to deploy. |
|
ElasticsearchRef is a reference to an Elasticsearch cluster running in the same Kubernetes cluster. |
|
Config holds the ElasticMapsServer configuration. See: https://www.elastic.co/guide/en/kibana/current/maps-connect-to-ems.html#elastic-maps-server-configuration |
|
ConfigRef contains a reference to an existing Kubernetes Secret holding the Elastic Maps Server configuration.
Configuration settings are merged and have precedence over settings specified in |
|
HTTP holds the HTTP layer configuration for Elastic Maps Server. |
|
PodTemplate provides customisation options (labels, annotations, affinity rules, resource requests, and so on) for the Elastic Maps Server pods |
|
RevisionHistoryLimit is the number of revisions to retain to allow rollback in the underlying Deployment. |
|
ServiceAccountName is used to check access from the current resource to a resource (for ex. Elasticsearch) in a different namespace. Can only be used if ECK is enforcing RBAC on references. |
Package v1alpha1 contains API schema definitions for managing StackConfigPolicy resources.
| Field | Description |
|---|---|
|
ClusterSettings holds the Elasticsearch cluster settings (/_cluster/settings) |
|
SnapshotRepositories holds the Snapshot Repositories settings (/_snapshot) |
|
SnapshotLifecyclePolicies holds the Snapshot Lifecycle Policies settings (/_slm/policy) |
|
SecurityRoleMappings holds the Role Mappings settings (/_security/role_mapping) |
|
IndexLifecyclePolicies holds the Index Lifecycle policies settings (/_ilm/policy) |
|
IngestPipelines holds the Ingest Pipelines settings (/_ingest/pipeline) |
|
IndexTemplates holds the Index and Component Templates settings |
|
Config holds the settings that go into elasticsearch.yml. |
|
SecretMounts are additional Secrets that need to be mounted into the Elasticsearch pods. |
|
SecureSettings are additional Secrets that contain data to be configured to Elasticsearch’s keystore. |
| Field | Description |
|---|---|
|
ComponentTemplates holds the Component Templates settings (/_component_template) |
|
ComposableIndexTemplates holds the Index Templates settings (/_index_template) |
| Field | Description |
|---|---|
|
Config holds the settings that go into kibana.yml. |
|
SecureSettings are additional Secrets that contain data to be configured to Kibana’s keystore. |
SecretMount contains information about additional secrets to be mounted to the elasticsearch pods
| Field | Description |
|---|---|
|
SecretName denotes the name of the secret that needs to be mounted to the elasticsearch pod |
|
MountPath denotes the path to which the secret should be mounted to inside the elasticsearch pod |
StackConfigPolicy represents a StackConfigPolicy resource in a Kubernetes cluster.
| Field | Description |
|---|---|
|
|
|
|
|
Refer to Kubernetes API documentation for fields of |
| Field | Description |
|---|---|
|
|
|
Deprecated: SecureSettings only applies to Elasticsearch and is deprecated. It must be set per application instead. |
|
|
|