aboutsummaryrefslogtreecommitdiffstats
path: root/docs/lma/logs/devguide.rst
blob: e2a7bad7e28bf359decf7feb24a829e89cf55feb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
.. (c) OPNFV, Spirent, AT&T, Ixia  and others.

.. Anuket ViNePerf LMA Documentation master file.

====================
Logs Developer Guide
====================

Ansible Client-side
-------------------

Ansible File Organisation
^^^^^^^^^^^^^^^^^^^^^^^^^
Files Structure::

    ansible-client
    ├── ansible.cfg
    ├── hosts
    ├── playbooks
    │   └── setup.yaml
    └── roles
        ├── clean-td-agent
        │   └── tasks
        │       └── main.yml
        └── td-agent
            ├── files
            │   └── td-agent.conf
            └── tasks
                └── main.yml

Summary of roles
^^^^^^^^^^^^^^^^
====================== ======================
Roles                  Description
====================== ======================
``td-agent``           Install Td-agent & change configuration file
``clean-td-agent``     Unistall Td-agent
====================== ======================

Configurable Parameters
^^^^^^^^^^^^^^^^^^^^^^^
====================================================== ====================== ======================
File (ansible-client/roles/)                           Parameter              Description
====================================================== ====================== ======================
``td-agent/files/td-agent.conf``                       host                   Fluentd-server IP
``td-agent/files/td-agent.conf``                       port                   Fluentd-Server Port
====================================================== ====================== ======================

Ansible Server-side
-------------------

Ansible File Organisation
^^^^^^^^^^^^^^^^^^^^^^^^^
Files Structure::

      ansible-server
      ├── ansible.cfg
      ├── group_vars
      │   └── all.yml
      ├── hosts
      ├── playbooks
      │   └── setup.yaml
      └── roles
          ├── clean-logging
          │   └── tasks
          │       └── main.yml
          ├── k8s-master
          │   └── tasks
          │       └── main.yml
          ├── k8s-pre
          │   └── tasks
          │       └── main.yml
          ├── k8s-worker
          │   └── tasks
          │       └── main.yml
          ├── logging
          │   ├── files
          │   │   ├── elastalert
          │   │   │   ├── ealert-conf-cm.yaml
          │   │   │   ├── ealert-key-cm.yaml
          │   │   │   ├── ealert-rule-cm.yaml
          │   │   │   └── elastalert.yaml
          │   │   ├── elasticsearch
          │   │   │   ├── elasticsearch.yaml
          │   │   │   └── user-secret.yaml
          │   │   ├── fluentd
          │   │   │   ├── fluent-cm.yaml
          │   │   │   ├── fluent-service.yaml
          │   │   │   └── fluent.yaml
          │   │   ├── kibana
          │   │   │   └── kibana.yaml
          │   │   ├── namespace.yaml
          │   │   ├── nginx
          │   │   │   ├── nginx-conf-cm.yaml
          │   │   │   ├── nginx-key-cm.yaml
          │   │   │   ├── nginx-service.yaml
          │   │   │   └── nginx.yaml
          │   │   ├── persistentVolume.yaml
          │   │   └── storageClass.yaml
          │   └── tasks
          │       └── main.yml
          └── nfs
              └── tasks
                  └── main.yml

Summary of roles
^^^^^^^^^^^^^^^^
====================== ======================
Roles                  Description
====================== ======================
``k8s-pre``            Pre-requisite for installing K8s, like installing docker & K8s, disable swap etc.
``k8s-master``         Reset K8s & make a master
``k8s-worker``         Join woker nodes with token
``logging``            EFK & elastalert setup in K8s
``clean logging``      Remove EFK & elastalert setup from K8s
``nfs``                Start a NFS server to store Elasticsearch data
====================== ======================

Configurable Parameters
^^^^^^^^^^^^^^^^^^^^^^^
========================================================================= ============================================ ======================
File (ansible-server/roles/)                                              Parameter name                               Description
========================================================================= ============================================ ======================
**Role: logging**
``logging/files/persistentVolume.yaml``                                   storage                                      Increase or Decrease Storage size of Persistent Volume size for each VM
``logging/files/kibana/kibana.yaml``                                      version                                      To Change the Kibana Version
``logging/files/kibana/kibana.yaml``                                      count                                        To increase or decrease the replica
``logging/files/elasticsearch/elasticsearch.yaml``                        version                                      To Change the Elasticsearch Version
``logging/files/elasticsearch/elasticsearch.yaml``                        nodePort                                     To Change Service Port
``logging/files/elasticsearch/elasticsearch.yaml``                        storage                                      Increase or Decrease Storage size of Elasticsearch data for each VM
``logging/files/elasticsearch/elasticsearch.yaml``                        nodeAffinity -> values (hostname)              In which VM Elasticsearch master or data pod will run (change the hostname to run the Elasticsearch master or data pod on a specific node)
``logging/files/elasticsearch/user-secret.yaml``                          stringData                                   Add Elasticsearch User & its roles (`Elastic Docs <https://www.elastic.co/guide/en/cloud-on-k8s/master/k8s-users-and-roles.html#k8s_file_realm>`_)
``logging/files/fluentd/fluent.yaml``                                     replicas                                     To increase or decrease the replica
``logging/files/fluentd/fluent-service.yaml``                             nodePort                                     To Change Service Port
``logging/files/fluentd/fluent-cm.yaml``                                  index_template.json -> number_of_replicas    To increase or decrease replica of data in Elasticsearch
``logging/files/fluentd/fluent-cm.yaml``                                  fluent.conf                                  Server port & other Fluentd Configuration
``logging/files/nginx/nginx.yaml``                                        replicas                                     To increase or decrease the replica
``logging/files/nginx/nginx-service.yaml``                                nodePort                                     To Change Service Port
``logging/files/nginx/nginx-key-cm.yaml``                                 kibana-access.key, kibana-access.pem         Key file for HTTPs Connection
``logging/files/nginx/nginx-conf-cm.yaml``                                -                                            Nginx Configuration
``logging/files/elastalert/elastalert.yaml``                              replicas                                     To increase or decrease the replica
``logging/files/elastalert/ealert-key-cm.yaml``                           elastalert.key, elastalert.pem               Key file for HTTPs Connection
``logging/files/elastalert/ealert-conf-cm.yaml``                          run_every                                    How often ElastAlert will query Elasticsearch
``logging/files/elastalert/ealert-conf-cm.yaml``                          alert_time_limit                             If an alert fails for some reason, ElastAlert will retry sending the alert until this time period has elapsed
``logging/files/elastalert/ealert-conf-cm.yaml``                          es_host, es_port                             Elasticsearch Serivce name & port in K8s
``logging/files/elastalert/ealert-rule-cm.yaml``                          http_post_url                                Alert Receiver IP (`Elastalert Rule Config <https://elastalert.readthedocs.io/en/latest/ruletypes.html>`_)
**Role: nfs**
``nfs/tasks/main.yml``                                                    line                                         Path of NFS storage
========================================================================= ============================================ ======================