07 . ELK Stack一键多机部署脚本
一键部署脚本
目录结构
tree Log_Analysis_Platform_Document
Log_Analysis_Platform_Document
├── InstallES.sh
├── InstallFilebeat.sh
├── InstallKibana.sh
└── README.md
ES.sh
#!/usr/bin/env bash
# *************************************************************************************************************
# Author: ZhouJian
# Mail: 18621048481@163.com
# Data: 2019-9-7
# Describe: CentOS 7 AutoInstall Elasticsearchn-7.2 Deploy Script
# ****************************Elasticsearch Deplay Script******************************************************
clear
ESIP=`ip addr | grep "inet" | grep -v "127.0.0.1" | grep -v "inet6" | awk -F/ '{print $1}' | awk '{print $2}' `
echo -e "\033[32m ############################################################################# \033[0m"
echo -e "\033[32m # Auto Install ELK. ## \033[0m"
echo -e "\033[32m # Press Ctrl + C to cancel ## \033[0m"
echo -e "\033[32m # Any key to continue ## \033[0m"
echo -e "\033[32m # Softwae:elasticsearch-7.2.0/logstash-7.2.0/filebeat-7.2.0/kibana-7.2.0 ## \033[0m"
echo -e "\033[32m ############################################################################# \033[0m"
Read_Input() {
echo -e "\033[32m Please Input You Kibana Pass Key IP: \033[0m"
read -p "Please Input You HOST Pass Key IP:[192.168.244.55]" KibanaIP
read -p "Please Input You HOST Pass Key IP: Password:" KibanaPass
echo -e "\033[32m Please Input You Filebeat Pass Key IP: \033[0m"
read -p "Please Input You HOST Pass Key IP:[192.168.244.56]" FilebeatIP
read -p "Please Input You HOST Pass Key IP: Password:" FilebeatPass
}
Init_Yumsource()
{
if ! ping -c2 www.baidu.com &>/dev/null
then
echo "您无法上外网，不能配置yum源"
exit
fi
echo "配置yum源"
if [ ! -d /etc/yum.repos.d/backup ];then
mkdir /etc/yum.repos.d/backup
mv /etc/yum.repos.d/* /etc/yum.repos.d/backup 2>/dev/null
curl -o /etc/yum.repos.d/163.repo http://mirrors.163.com/.help/CentOS7-Base-163.repo &>/dev/null
curl -o /etc/yum.repos.d/epel.repo http://mirrors.aliyun.com/repo/epel-7.repo &>/dev/null
fi
}
# *************************************************************************************************************
Init_Hostname()
{
hostnamectl set-hostname elk-1
echo "$ESIP elk-1" >> /etc/hosts
}
# *************************************************************************************************************
Init_SElinux()
{
echo "关闭防火墙"
systemctl stop firewalld
systemctl disable firewalld
echo "关闭selinux"
setenforce 0
sed -ri '/^SELINUX=/ s/enforcing/disabled/' /etc/selinux/config
echo "解决sshd远程连接慢的问题"
sed -ri '/^GSSAPIAu/ s/yes/no/' /etc/ssh/sshd_config
sed -ri '/^#UseDNS/ {s/^#//;s/yes/no/}' /etc/ssh/sshd_config
systemctl enable sshd crond &> /dev/null
}
# **************************************************************************************************************
Create_UserLogFile()
{
groupadd elk
useradd elk -g elk
mkdir -pv /data/elk/{data,logs}
chown -R elk:elk /data/
}
# **************************************************************************************************************
Unpackaged_Authorization()
{
yum -y install ntpdate
rpm -ivh /root/InstallELKB-Shell/jdk-8u121-linux-x64.rpm
tar xvf /root/InstallELKB-Shell/elasticsearch-7.2.0-linux-x86_64.tar.gz -C /opt/
chown -R elk:elk /opt/elasticsearch-7.2.0/
ntpdate -b ntp1.aliyun.com
}
# **************************************************************************************************************
Set_System_Parameter()
{
cat >> /etc/security/limits.conf <<EOF
* soft nproc 2048
* hard nproc 4096
* soft nofile 65536
* hard nofile 131072
EOF
echo "vm.max_map_count = 262144" >> /etc/sysctl.conf && sysctl -p
cat >> /etc/profile <<EOF
export HISTTIMEFORMAT="%Y-%m-%d %H:%M:%S "
EOF
source /etc/profile
cat >> /opt/elasticsearch-7.2.0/config/elasticsearch.yml <<EOF
cluster.name: elk
node.name: node-1
bootstrap.memory_lock: false
path.data: /data/elk/data
path.logs: /data/elk/logs
network.host: 0.0.0.0
http.port: 9200
discovery.seed_hosts: ["elk-1"]
cluster.initial_master_nodes: ["node-1"]
EOF
runuser -l elk -c '/bin/bash /opt/elasticsearch-7.2.0/bin/elasticsearch ' &> /opt/elasticsearch.log &
}
Test_Service()
{
esport=`ss -antp |grep :::9200 | awk -F::: '{print $2}'`
if [ $esport -eq 9200 ];then
echo -e "\033[32m Elasticsearch is OK... \033[0m "
fi
}
# **********************PublicKeyKibana******************************************************************************
PublicKeyKibana()
{
if [ ! -f /usr/bin/expect ];then
yum -y install expect
fi
sed -i 's/# *StrictHostKeyChecking *ask/StrictHostKeyChecking no/g' /etc/ssh/ssh_config
systemctl restart sshd
cd /root/.ssh/
ssh-keygen -t rsa -N '' -f id_rsa -q
if [ $? -eq 0 ];then
/usr/bin/expect <<-EOF
set timeout 10
spawn ssh-copy-id $KibanaIP
expect {
"yes/no" { send "yes\r"; exp_continue }
"password:" { send "$KibanaPass\r"}
}
expect eof
EOF
fi
}
# **********************Kibana Deploy Script********************************************************************
Install_Kibana()
{
echo $ESIP > /root/InstallELKB-Shell/ESIP.txt
scp /root/InstallELKB-Shell/kibana-7.2.0-linux-x86_64.tar.gz $KibanaIP:
scp /root/InstallELKB-Shell/ESIP.txt $KibanaIP:
scp /root/InstallELKB-Shell/InstallKibana.sh $KibanaIP:
ssh root@$KibanaIP '
bash /root/InstallKibana.sh '
}
# *******************************************Filebeat Deploy Script***************************************************
PublicFilebeat()
{
if [ ! -f /usr/bin/expect ];then
yum -y install expect
fi
sed -i 's/# *StrictHostKeyChecking *ask/StrictHostKeyChecking no/g' /etc/ssh/ssh_config
systemctl restart sshd
cd /root/.ssh/
rm -rf /root/.ssh/*
ssh-keygen -t rsa -N '' -f id_rsa -q
if [ $? -eq 0 ];then
/usr/bin/expect <<-EOF
set timeout 10
spawn ssh-copy-id $FilebeatIP
expect {
"yes/no" { send "yes\r"; exp_continue }
"password:" { send "$FilebeatPass\r"}
}
expect eof
EOF
fi
}
Install_Filebeat()
{
scp /root/InstallELKB-Shell/filebeat-7.2.0-x86_64.rpm $FilebeatIP:
scp /root/InstallELKB-Shell/InstallFilebeat.sh $FilebeatIP:
ssh root@$FilebeatIP 'bash /root/InstallFilebeat.sh'
scp /root/InstallELKB-Shell/filebeat.yml $FilebeatIP:/etc/filebeat/
ssh root@$FilebeatIP 'systemctl restart filebeat && systemctl disable filebeat && rm -rf /root/InstallFilebeat.sh'
}
# ********************************************Logstash******************************************************************
Install_logstash()
{
tar xvf /root/InstallELKB-Shell/logstash-7.2.0.tar.gz -C /opt/
cp /root/InstallELKB-Shell/nginx.yml /opt/logstash-7.2.0/
/opt/logstash-7.2.0/bin/logstash -f /opt/logstash-7.2.0/nginx.yml &>/opt/logstash.log &
}
ES-StartUp_SelfStart()
{
cat >> /etc/init.d/elasticsearch.sh <<EOF
nohup runuser -l elk -c '/bin/bash /opt/elasticsearch-7.2.0/bin/elasticsearch' &
nohup /opt/logstash-7.2.0/bin/logstash -f /opt/nginx.yml &
EOF
echo "/etc/init.d/elasticsearch.sh" >> /etc/rc.d/rc.local
chmod +x /etc/init.d/elasticsearch.sh
chmod +x /etc/rc.d/rc.local
}
main() {
#######Elasticsearch#######
Read_Input
Init_Yumsource
Init_Hostname
Init_SElinux
Create_UserLogFile
Unpackaged_Authorization
Set_System_Parameter
Test_Service
#########Kibana###########
PublicKeyKibana
Install_Kibana
########Filebeat#########
PublicFilebeat
Install_Filebeat
ES-StartUp_SelfStart
Kibana-StartUp_SelfStart
#######Logstash#########
Install_logstash
}
main
Kibana.sh
#!/usr/bin/env bash
# ***************************************************************************************************
# Author: ZhouJian
# MaiBox: 18621048481@163.com
# Data: 2019-9-7
# Describe: CentOS 7 Deploy Kibana Script
elastip=$(cat /root/ESIP.txt )
if [ ! -d /opt/kibana-7.2.0-linux-x86_64 ];then
tar xvf /root/kibana-7.2.0-linux-x86_64.tar.gz -C /opt/
fi
# ***************************************************************************************************
init_yumsource()
{
if ! ping -c2 www.baidu.com &>/dev/null
then
echo "您无法上外网，不能配置yum源"
exit
fi
echo "配置yum源"
if [ ! -d /etc/yum.repos.d/backup ];then
mkdir /etc/yum.repos.d/backup
mv /etc/yum.repos.d/* /etc/yum.repos.d/backup 2>/dev/null
curl -o /etc/yum.repos.d/163.repo http://mirrors.163.com/.help/CentOS7-Base-163.repo &>/dev/null
curl -o /etc/yum.repos.d/epel.repo http://mirrors.aliyun.com/repo/epel-7.repo &>/dev/null
yum -y install ntpdate
ntpdate -b ntp1.aliyun.com
fi
}
# ***************************************************************************************************
init_SElinux()
{
echo "关闭防火墙"
systemctl stop firewalld
systemctl disable firewalld
echo "关闭selinux"
setenforce 0
sed -ri '/^SELINUX=/ s/enforcing/disabled/' /etc/selinux/config
echo "解决sshd远程连接慢的问题"
sed -ri '/^GSSAPIAu/ s/yes/no/' /etc/ssh/sshd_config
sed -ri '/^#UseDNS/ {s/^#//;s/yes/no/}' /etc/ssh/sshd_config
systemctl enable sshd crond &> /dev/null
}
# ***************************************************************************************************
SetKibanaParameter()
{
cat >> /opt/kibana-7.2.0-linux-x86_64/config/kibana.yml <<EOF
server.host: "0.0.0.0"
server.port: 5601
elasticsearch.hosts: ["http://$elastip:9200"]
EOF
}
# ***************************************************************************************************
StartKibana()
{
/opt/kibana-7.2.0-linux-x86_64/bin/kibana --allow-root &>/opt/kibana.log &
}
Test_Service()
{
KibanaPort=` ss -antp | grep 5601 | awk '{print $4}' | awk -F*: '{print $NF}'`
if [ $KibanaPort -eq 5601 ];then
echo -e "\033[32m Kibana is OK... \033[0m "
fi
}
DeleteUselessFiles()
{
rm -rf /root/kibana-7.2.0-linux-x86_64.tar.gz
rm -rf /root/InstallKibana.sh
rm -rf /root/ESIP.txt
}
Kibana-StartUp_SelfStart()
{
echo "nohup /opt/kibana-7.2.0-linux-x86_64/bin/kibana --allow-root &" >> /etc/init.d/kibana.sh
echo "/bin/bash /etc/init.d/kibana.sh" >> /etc/rc.local
chmod +x /etc/init.d/kibana.sh
chmod +x /etc/rc.local
}
init_SElinux
SetKibanaParameter
StartKibana
Test_Service
DeleteUselessFiles
Kibana-StartUp_SelfStart
Filebeat.sh
#!/usr/bin/env bash # *************************************************************
# Author: ZhouJian
# Mail: 18621048481@163.com
# Data: 2019-9-7
# Describe: CentOS 7 Deploy Filebeat7.2 Script
# *************************************************************
Init_Yumsource()
{
if ! ping -c2 www.baidu.com &>/dev/null
then
echo "您无法上外网，不能配置yum源"
exit
fi
echo "配置yum源"
if [ ! -d /etc/yum.repos.d/backup ];then
mkdir /etc/yum.repos.d/backup
mv /etc/yum.repos.d/* /etc/yum.repos.d/backup 2>/dev/null
curl -o /etc/yum.repos.d/163.repo http://mirrors.163.com/.help/CentOS7-Base-163.repo &>/dev/null
curl -o /etc/yum.repos.d/epel.repo http://mirrors.aliyun.com/repo/epel-7.repo &>/dev/null
yum -y install ntpdate
ntpdate -b ntp1.aliyun.com
fi
}
Init_SElinux()
{
echo "关闭防火墙"
systemctl stop firewalld
systemctl disable firewalld
echo "关闭selinux"
setenforce 0
sed -i '/^SELINUX=/ s/enforcing/disabled/' /etc/selinux/config
echo "解决sshd远程连接慢的问题"
sed -i '/^GSSAPIAu/ s/yes/no/' /etc/ssh/sshd_config
sed -i '/^#UseDNS/ {s/^#//;s/yes/no/}' /etc/ssh/sshd_config
systemctl enable sshd crond &> /dev/null
}
Install_Filebeat()
{
yum -y install ntpdate
ntpdate -b ntp1.aliyun.com
rpm -ivh /root/filebeat-7.2.0-x86_64.rpm
rm -rf /root/filebeat-7.2.0-x86_64.rpm
}
Init_Yumsource
Init_SElinux
Install_Filebeat
README.md
环境要求：
# CentOS7
# Javaa 1.8
| IP | hostname | 软件 | 内存要求 |
|---|---|---|---|
| 192.168.122.3 | elk-1 | Elasticsearch、Logstash | 2G及以上 |
| 192.168.122.4 | Kibana | Kibana | 1G及以上 |
| 192.168.122.5 | Filebeat | Filebeat | 1G及以上 |
注意事项
# 1.一定要对时，时间校正，不然日志出不来；
# 2.java包最好用openjdk；
# 3.启动Elasticsearch必须切换成所创建的ELK用户启动，不然ES出于安全目的，会启动报错；
# 4.日志从Filebeat到Logstash再到ES检索到Kibana的读取速度取决于机器配置，注意用
# cat 日志文件* | wc -l 统计日志数量，然后到Elasticsearch去看总数量，确保日志都过来了在进行分析；
Elasticsearch安装
初始化
curl -o /etc/yum.repos.d/163.repo http://mirrors.163.com/.help/CentOS7-Base-163.repo &>/dev/null
curl -o /etc/yum.repos.d/epel.repo http://mirrors.aliyun.com/repo/epel-7.repo
yum -y install ntpdate
ntpdate -b ntp1.aliyun.com
设置Hostname解析
hostnamectl set-hostname elk-1
## 修改/etc/hosts 增加如下内容
192.168.122.3 elk-1
java安装
# 安装java 1.8
yum -y install java-1.8.0-openjdk.x86_64
关闭防火墙，SeLinux
setenforce 0
sed -i '/^SELINUX=/ s/enforcing/disabled/' /etc/selinux/config
systemctl stop firewalld
systemctl disable firewalld
sed -i '/^GSSAPIAu/ s/yes/no/' /etc/ssh/sshd_config
sed -i '/^#UseDNS/ {s/^#//;s/yes/no/}' /etc/ssh/sshd_config
创建用户和组
# create user elk
groupadd elk
useradd elk -g elk
创建数据及日志文件并授权
mkdir -pv /data/elk/{data,logs}
chown -R elk:elk /data/elk/
软件包解压、授权
# 上传软件包
# 通过scp 或者FTP方式上传到/opt下
# 解压软件包到/opt目录
tar xvf elasticsearch-7.2.0-linux-x86_64.tar.gz -C /opt/
# 授权
chown -R elk:elk # 软件包名
elk-1配置文件
# 集群名
cluster.name: elk
# 节点名
node.name: node-1
# 存储数据
path.data: /data/elk/data
# 存放日志
path.logs: /data/elk/logs
# 锁内存，尽量不使用交换内存
bootstrap.memory_locak: false
# 网络地址
network.host: 0.0.0.0
http.port: 9200
# 发现集群hosts
discovery.sead_hosts: ["elk-1"]
# 设置集群master节点
cluster.inital_master_nodes: ["node-1"]
修改/etc/security/limits.conf
# *号不是注释
* soft nofile 65536
* hard nofile 131072
* soft nproc 2048
* hard nproc 4096
修改/etc/sysctl.conf
echo "vm.max_map_count=262144" >> /etc/sysctl.conf
sysctl -p
ES启动
nohup runuser -l elk -c '/bin/bash /opt/elasticsearch-7.2.0/bin/elasticsearch' &
检查集群健康状态
curl -XGET 'elk-1:9200/_cluster/health?pretty'
Kibana安装使用
解压Kibana安装包
tar xvf kibana-7.2.0-linux-x86_64.tar.gz -C /opt/
修改Kibana配置文件
vim /opt/kibana-7.2.0-linux-x86_64/config/kibana.yml
server.port: 5601 # Port
server.host: 0.0.0.0 # 访问限制
elasticsearch.hosts: ["http://ESHostIP:9200"]
启动命令
/opt/kibana-7.2.0-linux-x86_64/bin/kibana --allow-root
nohup /opt/kibana-7.2.0-linux-x86_64/bin/kibana --allow-root & 放入后台使用
tailf nohup.out # 实时查看服务运行状态
Filebeat 安装使用
下载安装
修改配置文件(修改/etc/filebeat/filebeat.yml)
filebeat.inputs:
- type: log
enabled: true
paths:
- /var/log/*.log # 抓取文件日志路径
# output.elasticsearch:
# hosts: ["ESHostIP:9200"] # 输出到ES
Filebeat到Lostash
Filebeat配置
（vim /etc/filebeat/filebeat.yml） shift + ： 输入set nu 显示行号
24: enabled: true # 更改为true以启用输入配置
28: - /var/log/*.log # 替换为要抓取的日志文件路径
73： reload.enabled: true # 启动Filebeat模块
148： output.elasticsearch: # 加上注释；
150: hosts: ["localhost:9200"] # 加上注释；
158： output.logstash: # 去掉注释；
160： hosts: ["localhost:5044"] # 去掉注释，并修改localhost为logstash机器IP及对应端口号；
测试配置文件并启动
filebeat test config -e
systemctl start filebeat
systemctl enable filebeat
Logstash 安装使用
解压安装
上传包
tar xvf logstash-7.2.0.tar.gz -C /opt/
启动
/opt/logstash-7.2.0/bin/logstash -f /opt/配置文件名.yml
## 后台运行
nohup /opt/logstash-7.2.0/bin/logstash -f /opt/配置文件名.yml &
Logstash到Elasticsearch
主要看配置文件，配置文件对了，直接按照上面命令启动就可以了；
# Sample Logstash configuration for creating a simple
# Beats -> Logstash -> Elasticsearch pipeline.
input {
beats {
port => 5044
}
}
filter {
grok {
match => {
"message" => " %{DATA:log_date} %{TIME:log_localtime} %{JAVAFILE:name_file} %{WORD:workd}\[%{WORD:ls}\]\: %{DATA:log_date2} %{TIME:log_localtime2} %{WORD:year_tmp}\: %{WORD:name_2}\: %{WORD:} %{WORD:}\, %{JAVAFILE:}\: %{JAVAFILE:app_id}\, %{WORD}\: %{IP:ip}\, %{WORD:}\: %{INT}\, %{WORD}\: %{USERNAME:device_id}"
}
}
}
output {
elasticsearch {
hosts => ["http://ElasticsearchHostIP:9200"]
index => "nginx_log-%{[@metadata][beat]}-%{[@metadata][version]}-%{+YYYY.MM.dd}"
}
}
07 . ELK Stack一键多机部署脚本的更多相关文章
- 01 . ELK Stack简介原理及部署应用
简介 ELK并不是一款软件,是一整套解决方案,是由ElasticSearch,Logstash和Kibana三个开源工具组成:通常是配合使用,而且先后归于Elastic.co公司名下,简称ELK协议栈 ...
- ELK Stack部署
部署ELK Stack 官网:https://www.elastic.co 环境准备: ip hostname 服务 用户.组 192.168.20.3 node2003 kibana6.5,file ...
- 单个机器部署redis集群模式（一键部署脚本）
一.检查机器是否安装gcc.unzip.wget 二.部署模式 #模式1: 将所有主从节点以及sentinel节点部署在同一台机器上 #模式2: 将一个数据节点和一个sentinel节点部署在一台机器 ...
- Kubernetes实战之部署ELK Stack收集平台日志
主要内容 1 ELK概念 2 K8S需要收集哪些日志 3 ELK Stack日志方案 4 容器中的日志怎么收集 5 K8S平台中应用日志收集 准备环境 一套正常运行的k8s集群,kubeadm安装部署 ...
- 被一位读者赶超，手摸手 Docker 部署 ELK Stack
被一位读者赶超,容器化部署 ELK Stack 你好,我是悟空. 被奇幻"催更" 最近有个读者,他叫"老王",外号"茴香豆泡酒",找我崔更 ...
- 源码编译安装Apache-附一键部署脚本
1.进入apache官网https://www.apache.org/,点击Download 2.如图选择 3.选择httpd 4.下载两个包,2.2为CentOS6使用,2.4为CentOS7使用 ...
- shell脚本实例-mysql多机部署
今天我给大家分享shell 安装mysql 多机部署的实例,本次实验是基于各个主机的公钥已经配置好了,如果还不会推送公钥的同学,可以看看我以前写的文章,那里面有写推公钥的实例,mysql 多机部署一般 ...
- ceph集群一键部署脚本
分布式存储ceph相信大家比较熟悉了.某项目临时要做一个40个节点的存储集群.所以写了这个脚本. 一键部署脚本如下: git clone https://github.com/luckman666/d ...
- Linux 一键部署脚本
在当前路径下输入 chmod 777 脚本名 给脚本授权, 然后就可以执行脚本 ./脚本名 777 是最高权限,有读.写.执行权限:和属组用户和其他用户的读.写.执行权限. 其他权限分别是 -r ...
随机推荐
- pythonl操作数据库
目录 今日内容详细 Navicat软件 提示 练习题 pymysql模块 sql注入 navicat可视化界面操作数据库 数据库查询题目讲解(多表操作) python如何操作MySQL(pymysql ...
- Blazor带我重玩前端(三)
写在前面 需要升级VS2019以及.NET Core到最新版(具体的最低支持,我已经忘了,总是越新支持的就越好),以更好的支持自己开发Blazor项目. WebAssembly 搜索Blazor模板 ...
- 机器学习实战基础（十七）：sklearn中的数据预处理和特征工程（十）特征选择 之 Embedded嵌入法
Embedded嵌入法 嵌入法是一种让算法自己决定使用哪些特征的方法,即特征选择和算法训练同时进行.在使用嵌入法时,我们先使用某些机器学习的算法和模型进行训练,得到各个特征的权值系数,根据权值系数从大 ...
- electron代码审计
解包 Electron跨平台程序破解https://www.52pojie.cn/thread-563895-1-1.html Electron封装的跨平台程序破解的一般思路: 安装npm(至于如何安 ...
- bzoj1682[Usaco2005 Mar]Out of Hay 干草危机*
bzoj1682[Usaco2005 Mar]Out of Hay 干草危机 题意: 给个图,每个节点都和1联通,奶牛要从1到每个节点(可以走回头路),希望经过的最长边最短. 题解: 求最小生成树即可 ...
- day8 python 列表，元组，集合，字典的操作及方法 和 深浅拷贝
2.2 list的方法 # 增 list.append() # 追加 list.insert() # 指定索引前增加 list.extend() # 迭代追加(可迭代对象,打散追加) # 删 list ...
- Java顺序查找、二分查找
Java顺序查找.二分查找 查找算法中顺序查找算是最简单的了,无论是有序的还是无序的都可以,只需要一个个对比即可,但其实效率很低. 顺序查找 动图演示 详细代码 // 顺序查找 public st ...
- ES6面试
未完持续 概念 ECMAScript6(以下简称ES6)是 JavaScript 语言的下一代标准,前者是后者的规格,后者是前者的一种实现. ES6(新增的)一些特性 1.变.常量:let声明变量,c ...
- 水题----B - Badge CodeForces - 1020B
In Summer Informatics School, if a student doesn't behave well, teachers make a hole in his badge. A ...
- 快速配置webpack+vue项目
第一步:初始化项目 1.npm init 2. package name: (webpack+vue) webpackvue version: (1.0.0) description: this is ...