2qov3b / origin-aggregated-logging Goto Github PK

View Code? Open in Web Editor NEW

Shell 2.62% Go 0.01% Ruby 52.77% Python 0.11% Makefile 0.53% Awk 0.01% Gherkin 0.01% Dockerfile 0.04% JavaScript 21.73% M4 0.48% C 13.72% C++ 0.08% Java 2.36% HTML 1.57% Perl 0.52% Roff 0.60% XSLT 0.01% Assembly 1.16% CSS 1.60% Ragel 0.10%

origin-aggregated-logging's Introduction

OpenShift Logging

This repo primary contains only the image definitions for the components of the OpenShift Logging stack for releases 4.x and later. These components images, abbreviated as the "EFK" stack, include: Elasticsearch, Fluentd, Kibana. Please refer to the cluster-logging-operator and elasticsearch-operator for information regarding the operators which deploy these images.

The primary features this integration provides:

Multitenant support to isolate logs from various project namespaces
OpenShift OAuth2 integration
Log Forwarding
Historical log discovery and visualization
Log aggregation of pod and node logs

Information to build the images from github source using an OKD deployment is found here. See the quickstart guide to deploy cluster logging.

Please check the release notes for deprecated features or breaking changes .

Components

The cluster logging subsystem consists of multiple components commonly abbreviated as the "ELK" stack (though modified here to be the "EFK" stack).

Elasticsearch

Elasticsearch is a Lucene-based indexing object store into which logs are fed. Logs for node services and all containers in the cluster are fed into one deployed cluster. The Elasticsearch cluster should be deployed with redundancy and persistent storage for scale and high availability.

Fluentd

Fluentd is responsible for gathering log entries from nodes, enriching them with metadata, and forwarding them to the default logstore or other destinations defined by administrators.

Kibana

Kibana presents a web UI for browsing and visualizing logs in Elasticsearch.

Cluster Logging Operator

The cluster-logging-operator orchestrates the deployment of the cluster logging stack including: resource definitions, key/cert generation, component start and stop order.

Issues

Any issues can be filed at Red Hat Bugzilla. Please include as many details as possible in order to assist in issue resolution along with attaching a must gather output.