Era Software

No results match your query

Glossary

Estimated reading time: 3 minutes
  • explanatory
  • eracloud
  • self-hosted

This page defines commonly used terms for Era Software products.

alert rule
Copy
Copied!

Alert rules define when and where EraSearch sends alerts. You can create and edit alert rules based on your data and alerting needs.

Here's an example of an alert rule: If this query (code:404 AND method:GET) returns more than 5 results over the past 6 hours, send an alert to Slack.

Note: Only EraSearch on EraCloud supports alerting. Future self-hosted EraSearch releases will support alerting.

API Service
Copy
Copied!

The API Service is one of EraSearch's four internal database services. This service receives and handles all client requests. You can run several API Service instances for scalability.

batch
Copy
Copied!

A batch request is a write request issued to the database, which can include one or many documents.

Cache Service
Copy
Copied!

The Cache Service is one of EraSearch's four internal database services. This service handles the in-database hot cache, including:

  • Writing data to local storage
  • Compacting data to maximize query performance
  • Servicing query results from local storage

You can run several Cache Service instances for scalability.

compaction
Copy
Copied!

A compaction is when the database consolidates data on disk to optimize for read performance. Compactions include a "level", which is the number of times that the objects have been compacted together.

Coordinator Service
Copy
Copied!

The Coordinator Service is one of EraSearch's four internal database services. This service generates and works with object IDs (OIDs). OIDs are unique identifiers that EraSearch uses to store and retrieve data. Coordinator Service stores OIDs in Redis.

document
Copy
Copied!

A document is a JSON object made up of data. In EraSearch, all documents have a unique identifier (_id) and a timestamp (_ts). Most documents include additional fields. Here's an example of a document:

Copy
Copied!
{"_id":4248176661010579457,"_line":"access","response":200,"_ts":1634060854000}

EraCloud
Copy
Copied!

EraCloud is Era Software’s SaaS product, offering hosted EraSearch. As of October 2021, EraCloud supports Amazon Web Services only. Future releases will include Google Cloud Platform and Microsoft Azure.

EraSearch
Copy
Copied!

EraSearch is Era Software’s platform for log management. EraSearch has two main parts:

  • EraSearch database - A high-performance, cost-optimized, and scalable database
  • EraSearch UI - A UI for exploring and interacting with log data

Note: As of January 2022, only EraCloud comes with the EraSearch UI. Future self-hosted EraSearch releases will support the UI. Until then, self-hosted EraSearch users can use Grafana to visualize and interact with their data.

field
Copy
Copied!

A field is data stored as a key and value pair.

index
Copy
Copied!

An index is a group of similar documents. With EraSearch, you can query documents in one or more indexes to optimize your searches.

notification channel
Copy
Copied!

Notification channels are applications that can receive EraSearch alerts. EraSearch supports these notification channels: PagerDuty, Slack, and Webhooks.

Note: Only EraSearch on EraCloud supports alerting. Future self-hosted EraSearch releases will support alerting.

OID (Object ID)
Copy
Copied!

A unique identifier given to every document stored within an EraSearch index. Each OID is composed of a sequence number and other internal metadata.

root
Copy
Copied!

A root is how indexed data stored within EraSearch gets persisted to disk. Roots are similar in nature to "shards" used by Elasticsearch and other databases. Each batch request sent to the database creates a new root. Roots are then compacted over time to optimize for read performance.

rootset
Copy
Copied!

A rootset is set of files within a Cache Service node that represent all of the ingested data (aka "roots") that the node is aware of.

self-hosted EraSearch
Copy
Copied!

What we call EraSearch when you run and manage EraSearch yourself on your own cloud infrastructure.

Storage Service
Copy
Copied!

The Storage Service is one of EraSearch's four internal database services. The service optimizes communication with object storage (for example, S3 when running in AWS). It achieves high performance with minimal networking overhead.

sequence number
Copy
Copied!

A sequence number is a unique, monotonically (always) increasing number. Sequence numbers are included within the internal OID structure, ensuring a unique number per document ingested. The Coordinator Service is responsible for generating sequence numbers.