Logsearch 설치 가이드

Table of Contents
1. 개요
2. Logsearch 설치
2.1. Prerequisite
2.2. 설치 파일 다운로드
2.3. Logsearch 설치 환경설정
∙ common_vars.yml
∙ logsearch-vars.yml
∙ deploy-logsearch.sh
2.4. Logsearch 설치
2.5. 서비스 설치 확인​
1. 개요
본 문서(Logsearch 설치 가이드)는 PaaS-TA Monitoring을 설치하기 앞서 BOSH와 PaaS-TA의 VM Log 수집을 위하여 BOSH 2.0을 이용하여 Logsearch를 설치하는 방법을 기술하였다.
2. Logsearch 설치
2.1 Prerequisite
BOSH 설치가 되어있으며, BOSH Login이 되어 있어야 한다.
cloud-config와 runtime-config가 업데이트 되어있는지 확인한다.
Stemcell 목록을 확인하여 서비스 설치에 필요한 Stemcell(ubuntu xenial 621.78)이 업로드 되어 있는 것을 확인한다.
cloud-config 확인
$ bosh -e {director-name} cloud-config
runtime-config 확인
$ bosh -e {director-name} runtime-config
stemcell 확인
$ bosh -e {director-name} stemcells
2.2. 설치 파일 다운로드
Logsearch를 설치하기 위한 deployment가 존재하지 않는다면 다운로드 받는다
$ cd ${HOME}/workspace/paasta-5.5.0/deployment
$ git clone https://github.com/paas-ta/common.git –b v5.0.1
$ git clone https://github.com/paas-ta/monitoring-deployment.git –b v5.5.0
2.3. Logsearch 설치 환경설정
PaaS-TA VM Log수집을 위해서는 Logsearch가 설치되어야 한다.
$ cd ${HOME}/workspace/paasta-5.5.0/deployment/monitoring-deployment/logsearch
● common_vars.yml
common 폴더에 있는 common_vars.yml PaaS-TA 및 각종 Service 설치시 적용하는 공통 변수 설정 파일이 존재한다.
Logsearch를 설치할 때는 syslog_address의 값을 변경 하여 설치 할 수 있다.
syslog_address는 Monitoring 옵션을 포함한 BOSH와 PaaS-TA를 설치할 때의 변수값과 같은 값을 주어 설치를 한다.
# BOSH INFO
bosh_url: "http://10.0.1.6"            # BOSH URL (e.g. "https://00.000.0.0")
bosh_client_admin_id: "admin"            # BOSH Client Admin ID
bosh_client_admin_secret: "ert7na4jpewscztsxz48"    # BOSH Client Admin Secret('echo $(bosh int ~/workspace/paasta-5.5.0/deployment/paasta-deployment/bosh/{iaas}/creds.yml --path /admin_password)' 명령어를 통해 확인 가능)
bosh_director_port: 25555            # BOSH Director Port
bosh_oauth_port: 8443                # BOSH OAuth Port
​
# PAAS-TA INFO
system_domain: "61.252.53.246.xip.io"        # Domain (xip.io를 사용하는 경우 HAProxy Public IP와 동일)
paasta_admin_username: "admin"            # PaaS-TA Admin Username
paasta_admin_password: "admin"            # PaaS-TA Admin Password
paasta_nats_ip: "10.0.1.121"
paasta_nats_port: 4222
paasta_nats_user: "nats"
paasta_nats_password: "7EZB5ZkMLMqT73h2JtxPv1fvh3UsqO"    # PaaS-TA Nats Password (CredHub 로그인후 'credhub get -n /micro-bosh/paasta/nats_password' 명령어를 통해 확인 가능)
paasta_nats_private_networks_name: "default"    # PaaS-TA Nats 의 Network 이름
paasta_database_ips: "10.0.1.123"        # PaaS-TA Database IP(e.g. "10.0.1.123")
paasta_database_port: 5524            # PaaS-TA Database Port(e.g. 5524)
paasta_cc_db_id: "cloud_controller"        # CCDB ID(e.g. "cloud_controller")
paasta_cc_db_password: "cc_admin"        # CCDB Password(e.g. "cc_admin")
paasta_uaa_db_id: "uaa"                # UAADB ID(e.g. "uaa")
paasta_uaa_db_password: "uaa_admin"        # UAADB Password(e.g. "uaa_admin")
paasta_api_version: "v3"
​
​
# UAAC INFO
uaa_client_admin_id: "admin"            # UAAC Admin Client Admin ID
uaa_client_admin_secret: "admin-secret"        # UAAC Admin Client에 접근하기 위한 Secret 변수
uaa_client_portal_secret: "clientsecret"    # UAAC Portal Client에 접근하기 위한 Secret 변수
​
# Monitoring INFO
metric_url: "10.0.161.101"            # Monitoring InfluxDB IP
syslog_address: "10.0.121.100"                # Logsearch의 ls-router IP
syslog_port: "2514"                              # Logsearch의 ls-router Port
syslog_transport: "relp"                        # Logsearch Protocol
saas_monitoring_url: "61.252.53.248"           # Pinpoint HAProxy WEBUI의 Public IP
monitoring_api_url: "61.252.53.241"            # Monitoring-WEB의 Public IP
​
### Portal INFO
portal_web_user_ip: "52.78.88.252"
portal_web_user_url: "http://portal-web-user.52.78.88.252.xip.io" 
​
### ETC INFO
abacus_url: "http://abacus.61.252.53.248.xip.io"    # Abacus URL (e.g. "http://abacus.xxx.xxx.xxx.xxx.xip.io")
● logsearch-vars.yml
# SERVICE VARIABLE
inception_os_user_name: "ubuntu"        # Deployment Name
​
# STEMCELL
stemcell_os: "ubuntu-xenial"            # Stemcell OS
stemcell_version: "621.78"            # Stemcell Version
​
# ELASTICSEARCH-MASTER
elasticsearch_master_azs: ["z5"]        # Elasticsearch-Master 가용 존
elasticsearch_master_instances: 1        # Elasticsearch-Master 인스턴스 수
elasticsearch_master_vm_type: "medium"        # Elasticsearch-Master VM 종류
elasticsearch_master_network: "default"        # Elasticsearch-Master 네트워크
elasticsearch_master_persistent_disk_type: "10GB"    # Elasticsearch-Master 영구 Disk 종류
​
# CLUSTER-MONITOR
cluster_monitor_azs: ["z6"]            # Cluster-Monitor 가용 존
cluster_monitor_instances: 1            # Cluster-Monitor 인스턴스 수
cluster_monitor_vm_type: "medium"        # Cluster-Monitor VM 종류
cluster_monitor_network: "default"        # Cluster-Monitor 네트워크
cluster_monitor_persistent_disk_type: "10GB"    # Cluster-Monitor 영구 Disk 종류
​
# MAINTENANCE
maintenance_azs: ["z5"]                # Maintenance 가용 존
maintenance_instances: 1            # Maintenance 인스턴스 수
maintenance_vm_type: "medium"            # Maintenance VM 종류
maintenance_network: "default"            # Maintenance 네트워크
​
# ELASTICSEARCH-DATA
elasticsearch_data_azs: ["z5", "z6"]        # Elasticsearch-Data 가용 존
elasticsearch_data_instances: 2            # Elasticsearch-Data 인스턴스 수
elasticsearch_data_vm_type: "medium"        # Elasticsearch-Data VM 종류
elasticsearch_data_network: "default"        # Elasticsearch-Data 네트워크
elasticsearch_data_persistent_disk_type: "30GB"    # Elasticsearch-Data 영구 Disk 종류
​
# KIBANA
kibana_azs: ["z5"]                # Kibana 가용 존
kibana_instances: 1                # Kibana 인스턴스 수
kibana_vm_type: "medium"            # Kibana VM 종류
kibana_network: "default"            # Kibana 네트워크
kibana_persistent_disk_type: "5GB"        # Kibana 영구 Disk 종류
​
# INGESTOR
ingestor_azs: ["z4", "z6"]            # Ingestor 가용 존
ingestor_instances: 2                # Ingestor 인스턴스 수
ingestor_vm_type: "medium"            # Ingestor VM 종류
ingestor_network: "default"            # Ingestor 네트워크
ingestor_persistent_disk_type: "10GB"        # Ingestor 영구 Disk 종류
​
# LS-ROUTER
ls_router_azs: ["z4"]                    # LS-Router 가용 존
ls_router_instances: 1                  # LS-Router 인스턴스 수
ls_router_vm_type: "small"            # LS-Router VM 종류
ls_router_network: "default"            # LS-Router 네트워크
● deploy-logsearch.sh
bosh –e {director_name} -d logsearch deploy logsearch-deployment.yml \        
    -o operations/enable-router.yml \
    -l logsearch-vars.yml \
    -l ../../common/common_vars.yml
2.4. Logsearch 설치
서버 환경에 맞추어 Deploy 스크립트 파일의 설정을 수정한다.  
기본적으로 온라인 설치로 되어 있음.
$ vi ${HOME}/workspace/paasta-5.5.0/deployment/monitoring-deployment/logsearch/deploy-logsearch.sh
# .yml 파일들 설정 변경 이슈 있는지 같이 확인한다.  
bosh –e {director_name} -d logsearch deploy logsearch-deployment.yml \    
    -o operations/enable-router.yml \
    -l logsearch-vars.yml \
    -l ../../common/common_vars.yml
Logsearch 설치 Shell Script 파일 실행 (BOSH 로그인 필요)
$ cd ~/workspace/paasta-5.5.0/deployment/monitoring-deployment/logsearch
$ sh deploy-logsearch.sh
2.5. 서비스 설치 확인
logsearch가 설치 완료 되었음을 확인한다.
$ bosh –e {director_name} vms
Container 설치 가이드
Monasca 설치 가이드
Last updated 3 weeks ago