You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# Install `calyptia-fluentd` by DEB Package \(Debian/Ubuntu\)
2
+
3
+
This article explains how to install `calyptia-fluentd`, which is maintained by [Chronosphere](https://chronosphere.io) after its acquisition of Calyptia.
4
+
5
+
## What is `calyptia-fluentd`?
6
+
7
+
Fluentd is written in Ruby for flexibility, with performance-sensitive parts in C. However, some users may have difficulty installing and operating a Ruby daemon.
8
+
9
+
That is why Chronosphere (formerly Calyptia) provides **the alternative stable distribution of Fluentd**, called `calyptia-fluentd`.
10
+
11
+
## How to install `calyptia-fluentd`
12
+
13
+
### Step 0: Before Installation
14
+
15
+
Please follow the [Pre-installation Guide](before-install.md) to configure your OS properly.
16
+
17
+
### Step 1: Install from Apt Repository
18
+
19
+
NOTE: If your OS is not supported, consider [gem installation](install-by-gem.md) instead.
20
+
21
+
A shell script is provided to automate the installation process for each version. The shell script registers a new apt repository at `/etc/apt/sources.list.d/calyptia-fluentd.sources` and installs the `calyptia-fluentd` deb package.
22
+
23
+
For Ubuntu Focal:
24
+
25
+
```bash
26
+
# calyptia-fluentd 1
27
+
curl -fsSL https://calyptia-fluentd.s3.us-east-2.amazonaws.com/calyptia-fluentd-1-ubuntu-focal.sh | sh
28
+
```
29
+
30
+
For Ubuntu Bionic:
31
+
32
+
```bash
33
+
# calyptia-fluentd 1
34
+
curl -fsSL https://calyptia-fluentd.s3.us-east-2.amazonaws.com/calyptia-fluentd-1-ubuntu-bionic.sh | sh
35
+
```
36
+
37
+
For Ubuntu Xenial:
38
+
39
+
```bash
40
+
# calyptia-fluentd 1
41
+
curl -fsSL https://calyptia-fluentd.s3.us-east-2.amazonaws.com/calyptia-fluentd-1-ubuntu-xenial.sh | sh
42
+
```
43
+
44
+
For Debian Buster:
45
+
46
+
```bash
47
+
# calyptia-fluentd 1
48
+
curl -fsSL https://calyptia-fluentd.s3.us-east-2.amazonaws.com/calyptia-fluentd-1-debian-buster.sh | sh
49
+
```
50
+
51
+
### Step 2: Launch Daemon
52
+
53
+
### `systemd`
54
+
55
+
Use `/lib/systemd/system/calyptia-fluentd` script to `start`, `stop`, or `restart` the agent:
56
+
57
+
```text
58
+
$ sudo systemctl start calyptia-fluentd.service
59
+
$ sudo systemctl status calyptia-fluentd.service
60
+
● calyptia-fluentd.service - calyptia-fluentd: Fluentd based data collector for Calyptia Services
To customize `systemd` behavior, put your `calyptia-fluentd.service` in `/lib/systemd/system`.
73
+
74
+
Please make sure your configuration file path is:
75
+
76
+
```text
77
+
/etc/calyptia-fluentd/calyptia-fluentd.conf
78
+
```
79
+
80
+
### Step 3: Post Sample Logs via HTTP
81
+
82
+
The default configuration \(`/etc/calyptia-fluentd/calyptia-fluentd.conf`\) is to receive logs at an HTTP endpoint and route them to `stdout`. For `calyptia-fluentd` logs, see `/var/log/calyptia-fluentd/calyptia-fluentd.log`.
83
+
84
+
You can post sample log records with `curl` command:
85
+
86
+
```text
87
+
$ curl -X POST -d 'json={"json":"message"}' http://localhost:8888/debug.test
*[Store Apache Log into Amazon S3](../how-to-guides/apache-to-s3.md)
104
+
*[Store Apache Log into MongoDB](../how-to-guides/apache-to-mongodb.md)
105
+
*[Data Collection into HDFS](../how-to-guides/http-to-hdfs.md)
106
+
107
+
If this article is incorrect or outdated, or omits critical information, please [let us know](https://github.com/fluent/fluentd-docs-gitbook/issues?state=open). [Fluentd](http://www.fluentd.org/) is an open-source project under [Cloud Native Computing Foundation \(CNCF\)](https://cncf.io/). All components are available under the Apache 2 License.
Copy file name to clipboardExpand all lines: installation/install-by-deb-fluent-package.md
+4-97Lines changed: 4 additions & 97 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,22 +1,16 @@
1
-
# Install by DEB Package \(Debian/Ubuntu\)
1
+
# Install `fluent-package`by DEB Package \(Debian/Ubuntu\)
2
2
3
-
This article explains how to install stable versions of `fluent-package` deb packages, the stable Fluentd distribution packages maintained by [Fluentd Project](https://www.fluentd.org/) and `calyptia-fluentd` which is maintained by [Chronosphere](https://chronosphere.io) after its acquisition of Calyptia.
3
+
This article explains how to install stable versions of `fluent-package` deb packages, the stable Fluentd distribution packages maintained by [Fluentd Project](https://www.fluentd.org/).
4
4
5
5
## What is `fluent-package`?
6
6
7
7
Fluentd is written in Ruby for flexibility, with performance-sensitive parts in C. However, some users may have difficulty installing and operating a Ruby daemon.
8
8
9
9
That is why [Fluentd Project](https://www.fluentd.org/) provides **the stable distribution of Fluentd**, called `fluent-package` (formerly known as `td-agent`). The differences between Fluentd and `fluent-package` can be found [here](https://www.fluentd.org/faqs).
10
10
11
-
## What is `calyptia-fluentd`?
11
+
You can also see [fluent-package-v5-vs-td-agent](../quickstart/fluent-package-v5-vs-td-agent.md) for the comparison and supported OS.
12
12
13
-
Fluentd is written in Ruby for flexibility, with performance-sensitive parts in C. However, some users may have difficulty installing and operating a Ruby daemon. And `td-agent` is still seated on Ruby 2.7 due to compatibility reasons and Ruby versioning policy, `calyptia-fluentd` uses Ruby 3 instead of Ruby 2.7 for now.
14
-
15
-
That is why Chronosphere (formerly Calyptia) provides **the alternative stable distribution of Fluentd**, called `calyptia-fluentd`. The differences between `td-agent` and `calyptia-fluentd` are bundled and running Ruby versions for now.
16
-
17
-
This installation guide is for `fluent-package` v5 and `calyptia-fluentd` v1. `fluent-package` v5 and `calyptia-fluentd` use fluentd v1 in the core. See [fluent-package-v5-vs-td-agent](../quickstart/fluent-package-v5-vs-td-agent.md) or [td-agent-v2-vs-v3-vs-v4](../quickstart/td-agent-v2-vs-v3-vs-v4.md) for the comparison and supported OS.
Please follow the [Pre-installation Guide](before-install.md) to configure your OS properly.
156
-
157
-
### Step 1: Install from Apt Repository
158
-
159
-
NOTE: If your OS is not supported, consider [gem installation](install-by-gem.md) instead.
160
-
161
-
A shell script is provided to automate the installation process for each version. The shell script registers a new apt repository at `/etc/apt/sources.list.d/calyptia-fluentd.sources` and installs the `calyptia-fluentd` deb package.
162
-
163
-
For Ubuntu Focal:
164
-
165
-
```bash
166
-
# calyptia-fluentd 1
167
-
curl -fsSL https://calyptia-fluentd.s3.us-east-2.amazonaws.com/calyptia-fluentd-1-ubuntu-focal.sh | sh
168
-
```
169
-
170
-
For Ubuntu Bionic:
171
-
172
-
```bash
173
-
# calyptia-fluentd 1
174
-
curl -fsSL https://calyptia-fluentd.s3.us-east-2.amazonaws.com/calyptia-fluentd-1-ubuntu-bionic.sh | sh
175
-
```
176
-
177
-
For Ubuntu Xenial:
178
-
179
-
```bash
180
-
# calyptia-fluentd 1
181
-
curl -fsSL https://calyptia-fluentd.s3.us-east-2.amazonaws.com/calyptia-fluentd-1-ubuntu-xenial.sh | sh
182
-
```
183
-
184
-
For Debian Buster:
185
-
186
-
```bash
187
-
# calyptia-fluentd 1
188
-
curl -fsSL https://calyptia-fluentd.s3.us-east-2.amazonaws.com/calyptia-fluentd-1-debian-buster.sh | sh
189
-
```
190
-
191
-
### Step 2: Launch Daemon
192
-
193
-
### `systemd`
194
-
195
-
Use `/lib/systemd/system/calyptia-fluentd` script to `start`, `stop`, or `restart` the agent:
196
-
197
-
```text
198
-
$ sudo systemctl start calyptia-fluentd.service
199
-
$ sudo systemctl status calyptia-fluentd.service
200
-
● calyptia-fluentd.service - calyptia-fluentd: Fluentd based data collector for Calyptia Services
To customize `systemd` behavior, put your `calyptia-fluentd.service` in `/lib/systemd/system`.
213
-
214
-
Please make sure your configuration file path is:
215
-
216
-
```text
217
-
/etc/calyptia-fluentd/calyptia-fluentd.conf
218
-
```
219
-
220
-
### Step 3: Post Sample Logs via HTTP
221
-
222
-
The default configuration \(`/etc/calyptia-fluentd/calyptia-fluentd.conf`\) is to receive logs at an HTTP endpoint and route them to `stdout`. For `calyptia-fluentd` logs, see `/var/log/calyptia-fluentd/calyptia-fluentd.log`.
223
-
224
-
You can post sample log records with `curl` command:
225
-
226
-
```text
227
-
$ curl -X POST -d 'json={"json":"message"}' http://localhost:8888/debug.test
If this article is incorrect or outdated, or omits critical information, please [let us know](https://github.com/fluent/fluentd-docs-gitbook/issues?state=open). [Fluentd](http://www.fluentd.org/) is an open-source project under [Cloud Native Computing Foundation \(CNCF\)](https://cncf.io/). All components are available under the Apache 2 License.
This article explains how to install stable versions of `fluent-package` dmg packages, the stable Fluentd distribution packages maintained by [Fluentd Project](https://www.fluentd.org/) and `calyptia-fluentd` which is maintained by [Chronosphere](https://chronosphere.io) after its acquisition of Calyptia on macOS.
4
-
5
-
## What is `fluent-package`?
6
-
7
-
Fluentd is written in Ruby for flexibility, with performance-sensitive parts in C. However, some users may have difficulty installing and operating a Ruby daemon.
8
-
9
-
That is why [Fluentd Project](https://www.fluentd.org/) provides **the stable distribution of Fluentd**, called `fluent-package`. The differences between Fluentd and `fluent-package` can be found [here](https://www.fluentd.org/faqs).
3
+
This article explains how to install `calyptia-fluentd`, which is maintained by [Chronosphere](https://chronosphere.io) after its acquisition of Calyptia on macOS.
10
4
11
5
## What is `calyptia-fluentd`?
12
6
13
-
Fluentd is written in Ruby for flexibility, with performance-sensitive parts in C. However, some users may have difficulty installing and operating a Ruby daemon. And `td-agent` is still seated on Ruby 2.7 due to compatibility reasons and Ruby versioning policy, `calyptia-fluentd` uses Ruby 3 instead of Ruby 2.7 for now.
7
+
Fluentd is written in Ruby for flexibility, with performance-sensitive parts in C. However, some users may have difficulty installing and operating a Ruby daemon.
14
8
15
-
That is why Chronosphere (formerly Calyptia) provides **the alternative stable distribution of Fluentd**, called `calyptia-fluentd`. The differences between `td-agent` and `calyptia-fluentd` are bundled and running Ruby versions for now.
9
+
That is why Chronosphere (formerly Calyptia) provides **the alternative stable distribution of Fluentd**, called `calyptia-fluentd`.
16
10
17
11
For macOS, `td-agent` is distributed as `.dmg` installer.
18
12
19
-
## `fluent-package` v5
20
-
21
-
{% hint style='info' %}
22
-
NOTE:
23
-
24
-
* About Treasure Agent (td-agent) v4, see [Install by .dmg Package \(macOS\)](install-by-dmg-td-agent-v4.md).
25
-
* About deprecated [Treasure Agent (td-agent) 3 will not be maintained anymore](https://www.fluentd.org/blog/schedule-for-td-agent-3-eol), see [Install by DEB Package v3](install-by-deb-td-agent-v3.md).
26
-
*`fluent-package` is not be shipped yet, we plan to migrate to homebrew ecosystem in the future.
27
-
28
-
{% endhint %}
29
-
30
-
<!-- Revise instructions when fluent-package with homebrew was released
The default configuration \(`/etc/fluent/fluentd.conf`\) is to receive logs at an HTTP endpoint and route them to `stdout`. For `fluentd` logs, see `/var/log/fluent/fluentd.log`.
62
-
63
-
You can post sample log records with `curl` command:
64
-
65
-
```text
66
-
$ curl -X POST -d 'json={"json":"message"}' http://localhost:8888/debug.test
If this article is incorrect or outdated, or omits critical information, please [let us know](https://github.com/fluent/fluentd-docs-gitbook/issues?state=open). [Fluentd](http://www.fluentd.org/) is an open-source project under [Cloud Native Computing Foundation \(CNCF\)](https://cncf.io/). All components are available under the Apache 2 License.
0 commit comments