Fluentd
Search…
1.0
Introduction
Overview
Installation
Configuration
Config File Syntax
Routing Examples
Config: Common Parameters
Config: Parse Section
Config: Buffer Section
Config: Format Section
Config: Extract Section
Config: Inject Section
Config: Transport Section
Config: Storage Section
Config: Service Discovery Section
Deployment
Container Deployment
Monitoring Fluentd
Input Plugins
Output Plugins
Filter Plugins
Parser Plugins
Formatter Plugins
Buffer Plugins
Storage Plugins
Service Discovery Plugins
Metrics Plugins
How-to Guides
Language Bindings
Plugin Development
Plugin Helper API
Troubleshooting Guide
Powered By GitBook
Config: Inject Section

Inject section overview

The inject section can be under <match> or <filter> section. It is enabled for the plugins that support injecting values to the event record.
1
<match>
2
@type file
3
# ...
4
<inject>
5
# ...
6
</inject>
7
</match>
Copied!

Example

Configuration:
1
<inject>
2
time_key fluentd_time
3
time_type string
4
time_format %Y-%m-%dT%H:%M:%S.%NZ
5
tag_key fluentd_tag
6
</inject>
Copied!
Event Record:
1
tag: test
2
time: 1547575563.952259
3
record: {"message":"hello"}
Copied!
Injected Record:
1
{"message":"hello","fluentd_tag":"test","fluentd_time":"2019-01-15T18:06:03.952259000Z"}
Copied!

Inject Section Parameter

Inject Parameters

  • hostname_key (string) (optional): the field name to inject hostname
    • Default: nil
  • hostname (string) (optional): hostname value
    • Default: Socket.gethostname
  • worker_id_key (string) (optional): the field name to inject
    worker_id
    • Default: nil
  • tag_key (string) (optional): the field name to inject tag
    • Default: nil
  • time_key (string) (optional): the field name to inject time
    • Default: nil

Time Parameters

  • time_type (enum) (optional): parses/formats value according to this
    type
    • Default: float
    • Available values:
      • float: seconds from Epoch + microseconds (e.g.
        1510544836.154709)
      • unixtime: seconds from Epoch (e.g. 1510544836)
      • unixtime_millis (since v1.11.4): milliseconds from Epoch
        (e.g. 1510544836154)
      • unixtime_micros (since v1.20.0): microseconds from Epoch
        (e.g. 1510544836154709)
      • unixtime_nanos (since v1.20.0): nanoseconds from Epoch
        (e.g. 1510544836154709804)
      • string: use format specified by time_format, local time or time
        zone
  • time_format (string) (optional): processes value according to the
    specified format. This is available only when time_type is string.
    • Default: nil
    • Available time format:
      • For more details about formatting, see
        ​Time#strftime.
      • For more details about parsing, see
        ​Time.strptime.
      • %iso8601 (only for parsing)
      • Use %N to parse/format with sub-second precision, because
        ​strptime does not support
        %3N, %6N, %9N, and %L.
  • localtime (bool) (optional): if true, uses local time. Otherwise,
    UTC is used. This is exclusive with utc.
    • Default: true
  • utc (bool) (optional): if true, uses UTC. Otherwise, local time is
    used. This is exclusive with localtime.
    • Default: false
  • timezone (string) (optional): uses the specified timezone. One can
    parse/format the time value in the specified timezone format.
    • Default: nil
    • Available time zone format:
      1. 1.
        [+-]HH:MM (e.g. "+09:00") (recommended)
      2. 2.
        [+-]HHMM (e.g. "+0900")
      3. 3.
        [+-]HH (e.g. "+09")
      4. 4.
        Region/Zone (e.g. Asia/Tokyo)
      5. 5.
        Region/Zone/Zone (e.g. America/Argentina/Buenos_Aires)
If this article is incorrect or outdated, or omits critical information, please let us know. Fluentd is an open-source project under Cloud Native Computing Foundation (CNCF). All components are available under the Apache 2 License.
Previous
Config: Extract Section
Next
Config: Transport Section
Last modified 1yr ago
Copy link
Contents
Inject section overview
Example
Inject Section Parameter
Inject Parameters
Time Parameters