Apache Karaf Decanter 2.x - Documentation

• 语言: 英语
• 格式: .pdf
• 来源: downloads.apache.org

摘要

文档详细介绍了Apache Karaf Decanter 2.x的各个组件及其配置方法，包括Redis appender、系统收集器、网络套接字收集器、Elasticsearch收集器等。文档提供了如何安装这些功能模块、配置文件的位置及各项配置参数的详细说明。内容涵盖了数据收集、传输、存储以及如何自定义属性和处理器的实现。

AI总结

### Apache Karaf Decanter 2.x Documentation Summary

#### 1. **Redis Appender**
- **Purpose**: Sends collected data to a Redis broker.
- **Installation**: `karaf@root()> feature:install decanter-appender-redis`
- **Configuration**:
- `address`: Redis broker address (default: `localhost:6379`).
- `mode`: Connection mode (Single, Master_Slave, Sentinel, Cluster).
- `map`: Redis map name (default: `Decanter`).

#### 2. **System Collector**
- **Purpose**: Executes OS commands or scripts periodically.
- **Installation**: `karaf@root()> feature:install decanter-collector-system`
- **Configuration**:
- `thread.number`: Number of parallel execution threads (default: 1).
- Commands can be defined using the format `command.key=command_to_execute`.

#### 3. **Network Socket Collector**
- **Purpose**: Listens for incoming network messages.
- **Installation**: `karaf@root()> feature:install decanter-collector-socket`
- **Configuration**:
- `port`: Listening port (default: 34343).
- `workers`: Number of worker threads (default: 10).
- `protocol`: TCP or UDP (default: TCP).
- `unmarshaller.target`: Data format (default: JSON).

#### 4. **Elasticsearch Collector**
- **Purpose**: Retrieves documents from Elasticsearch periodically.
- **Installation**: `karaf@root()> feature:install decanter-collector-elasticsearch`
- **Configuration**:
- `addresses`: Elasticsearch instance addresses (default: `http://localhost:9200`).
- `index`: Target index (default: `decanter`).
- `query`: Search query (default: match all documents).

#### 5. **Customizing Collector Properties**
- **Functionality**: Modify properties before sending to the dispatcher.
- **Configuration**: Add, rename, or remove properties in the collector configuration file (e.g., `etc/org.apache.karaf.decanter.collector.jmx-local.cfg`).

#### 6. **Cassandra Appender**
- **Purpose**: Stores data in Cassandra.
- **Configuration**:
- `keyspace.name`: Target keyspace (default: `decanter`).
- `table.name`: Target table (default: `decanter`).
- `cassandra.host`: Hostname or IP (default: `localhost`).
- `cassandra.port`: Port (default: 9042).

#### 7. **InfluxDB Appender**
- **Purpose**: Stores time series data in InfluxDB.
- **Installation**: `karaf@root()> feature:install decanter-appender-influxdb`.
- **Configuration**: Config file includes InfluxDB connection details.

#### 8. **Data Processing and Parsing**
- **Split Parser**: Parses data using a separator (e.g., `,`).
- **Regex Parser**: Uses regex groups for parsing.
- **Configuration**: Define parsers in `etc/org.apache.karaf.decanter.collector.file-XXXX.cfg`.

#### 9. **Alerters and Processors**
- **Alerters**: Send notifications based on events.
- **Processors**: Transform events using custom logic (e.g., `PassThroughProcessor`).

#### 10. **Custom Functionality**
- **Implementation**: Extend functionality by creating custom processors and parsers.

---

### Key Features:
- **Data Collection**: Supports Redis, Elasticsearch, Cassandra, InfluxDB, and custom data sources.
- **Data Processing**: Includes parsers for splitting and regex-based data processing.
- **Customization**: Ability to modify properties, implement custom processors, and extend functionality.
- **Integration**: Supports various protocols (TCP, UDP) and data formats (JSON).

This summary provides a concise overview of the core components and configurations in Apache Karaf Decanter 2.x, focusing on essential features and key implementation details.