PaaS-TA Monitoring 설치 가이드

Table of Contents

1. 개요 2. PaaS-TA Monitoring 설치 2.1. Prerequisite 2.2. 설치 파일 다운로드 2.3. PaaS-TA Monitoring 설치 환경설정 ∙ common_vars.yml ∙ paasta-monitoring-vars.yml ∙ deploy-paasta-monitoring.sh 2.4. PaaS-TA Monitoring 설치 2.5. 서비스 설치 확인 3. PaaS-TA Monitoring Dashboard 접속

1. 개요

본 문서(PaaS-TA Monitoring 설치 가이드)는 전자정부프레임워크 기반의 PaaS-TA 5.1 환경 기준으로 BOSH 2.0을 이용하여 PaaS-TA Monitoring 설치를 위한 가이드를 제공한다.

2. PaaS-TA Monitoring 설치

2.1. Prerequisite

1. BOSH 설치가 되어있으며, BOSH Login이 되어 있어야 한다.

2. cloud-config와 runtime-config가 업데이트 되어있는지 확인한다.

3. Stemcell 목록을 확인하여 서비스 설치에 필요한 Stemcell(ubuntu xenial 621.78)이 업로드 되어 있는 것을 확인한다.

4. PaaS-TA 5.0이 설치되어 있어야 하며, BOSH와 PaaS-TA를 설치하는 과정에서 Monitoring 옵션을 포함하여 설치되어 있어야 한다.

5. PaaS(logsearch), IaaS(Monasca), SaaS(PaaS-TA Pinpoint Monitoring), CaaS(PaaS-TA CaaS Service)등 Monitoring을 하고 싶은 환경에 해당되는 서비스가 설치되어 있어야 한다. (logsearch 설치 필수)

cloud-config 확인 $ bosh -e {director-name} cloud-config

runtime-config 확인 $ bosh -e {director-name} runtime-config

stemcell 확인 $ bosh -e {director-name} stemcells

2.2. 설치 파일 다운로드

• PaaS-TA Monitoring을 설치하기 위한 deployment가 존재하지 않는다면 다운로드 받는다

$ cd ${HOME}/workspace/paasta-5.1/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

기본적으로 온라인 설치로 설정되어 있으나 오프라인 설치 시 release, stemcell 설치 파일 다운로드는 아래 다운로드 에서 받고 설치한다.

아래 주소로 이동한다. 관련 release, stemcell 파일들을 받을 수 있다.
https://nextcloud.paas-ta.org/index.php/s/Z2zfK6RjYNE3CeT

위 주소 항목 중 아래 경로로 이동하면 paasta-monitoring 파일을 받을 수 있다
release > paasta-monitoring > paasta-monitoring-release-5.5.tgz

2.3. PaaS-TA Monitoring 설치 환경설정

${HOME}/workspace/paasta-5.1/deployment/monitoring-deployment/paasta-monitoring 이하 디렉터리에는 PaaS-TA Monitoring 설치를 위한 Shell Script 파일이 존재한다.

● common_vars.yml

common 폴더에 있는 common_vars.yml PaaS-TA 및 각종 Service 설치시 적용하는 공통 변수 설정 파일이 존재한다. PaaS-TA Monitoring을 설치할 때는 paasta_admin_username, paasta_admin_password, metric_url, monitoring_api_url, saas_monitoring_url 값을 변경 하여 설치 할 수 있다. paasta_admin_username, paasta_admin_password는 PaaS-TA를 설치할 때의 변수값과 같은 값을 주어 설치를 한다 metric_url는 Monitoring 옵션을 포함한 BOSH와 PaaS-TA를 설치할 때의 변수값과 같은 값을 주어 설치를 한다. saas_monitoring_url는 Pinpoint Monitoring을 설치할 때의 변수값과 같은 값을 주어 설치를 한다.

# BOSH
bosh_url: "10.0.1.6"                # BOSH URL ('bosh env' 명령어를 통해 확인 가능)
bosh_client_admin_id: "admin"            # BOSH Client Admin ID
bosh_client_admin_secret: "ert7na4jpewscztsxz48"    # BOSH Client Admin Secret

# PAAS-TA
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
uaa_client_admin_secret: "admin-secret"        # UAAC Admin Client에 접근하기 위한 Secret 변수
uaa_client_portal_secret: "clientsecret"    # UAAC Portal Client에 접근하기 위한 Secret 변수

# MONITORING
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
monitoring_api_url: "61.252.53.241"        # Monitoring-WEB의 Public IP
saas_monitoring_url: "61.252.53.248"        # Pinpoint HAProxy WEBUI의 Public IP

● paasta-monitoring-vars.yml

# SERVICE VARIABLE
inception_os_user_name: "ubuntu"
mariadb_ip: "10.0.161.100"        # MariaDB VM Private IP
mariadb_port: "3306"            # MariaDB Port
mariadb_username: "root"        # MariaDB Root 계정 Username
mariadb_password: "password"        # MariaDB Root 계정 Password
director_name: "micro-bosh"        # BOSH Director 명
resource_url: "resource_url"        # TBD
paasta_deploy_name: "paasta"        # PaaS-TA Deployment 명
paasta_cell_prefix: "cell"        # PaaS-TA Cell 명
smtp_url: "smtp.naver.com"        # SMTP Server URL
smtp_port: "587"            # SMTP Server Port
mail_sender: "[e-mail]"        # SMTP Server Admin ID
mail_password: "aaaa"            # SMTP Server Admin Password
mail_enable: "true"            # Alarm 발생시 Mail전송 여부
mail_tls_enable: "true"            # SMTP 서버 인증시 TLS모드인경우 true
redis_ip: "10.0.121.101"        # Redis Private IP
redis_password: "password"        # Redis 인증 Password
utc_time_gap: "9"            # UTC Time Zone과 Client Time Zone과의 시간 차이
public_network_name: "vip"        # Monitoring-WEB Public Network Name
system_type: "PaaS,CaaS,SaaS"        # 모니터링 할 환경 선택
prometheus_ip: "10.0.121.122"        # Kubernates의 prometheus-prometheus-prometheus-oper-prometheus-0 Pod의 Node IP
kubernetes_ip: "10.0.0.124"        # Kubernates의 서비스 API IP
pinpoint_was_ip: "10.0.0.122"        # Pinpoint HAProxy WEBUI Private IP
cassbroker_ip: "52.141.6.113"        # CaaS 서비스 로그인 인증 처리를 위한 API IP
kubernetes_token: "eyJhbGciOiJSUzI1NiIsImtpZCI6IiJ9.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJrdWJlLXN5c3RlbSIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VjcmV0Lm5hbWUiOiJtb25pdG9yaW5nLWFkbWluLXRva2VuLWQ0OXc3Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZXJ2aWNlLWFjY291bnQubmFtZSI6Im1vbml0b3JpbmctYWRtaW4iLCJrdWJlcm5ldGVzLmlvL3NlcnZpY2VhY2NvdW50L3NlcnZpY2UtYWNjb3VudC51aWQiOiI4MDkwNTU5Yy0wYzE2LTExZWEtYjZiYi0wMDIyNDgwNTk4NzciLCJzdWIiOiJzeXN0ZW06c2VydmljZWFjY291bnQ6a3ViZS1zeXN0ZW06bW9uaXRvcmluZy1hZG1pbiJ9.ZKPWJLo0LFXY9ZpW7nGlTBLJYDNL7MFB9X1i4JoEn8jPLsCQhG3lvzTjh7420lvoP5hWdV0SpsMMfZnV2WFFUWaQkYcnKhB2qsVX_xOd45gm2IfI-f1QmxcAspoGY_r8kC-vX9L4oTLA5sJTI5m_RIiuckVGcVR0OeWB5NtUFz0-iCpQRfuy9LYH0NCEEopfDji-T0Pxta8S1n8YyxVwYKpZE0PvT9H9ZVNUUAt2Z_l4B0akP6G3O6t53Xvp_l8DXzxRFXTw3sHPvvea_Uv3QbGcFkH-gNHBeG9-F8C8NMcSlCUeyAGfxZlpsdRFMB01Wh6RZzvUqeS8Kc-8Csp_jw"    # Kubernetes 서비스 API Request 호출시 Header(Authorization) 인증을 위한 Token값 

# STEMCELL
stemcell_os: "ubuntu-xenial"        # Stemcell OS
stemcell_version: "621.78"        # Stemcell Version


# REDIS
redis_azs: ["z4"]            # Redis 가용 존
redis_instances: 1            # Redis 인스턴스 수
redis_vm_type: "small"            # Redis VM 종류
redis_network: "default"        # Redis 네트워크

# SANITY-TEST
sanity_tests_azs: ["z4"]        # Sanity-Test 가용 존
sanity_tests_instances: 1        # Sanity-Test 인스턴스 수
sanity_tests_vm_type: "small"        # Sanity-Test VM 종류
sanity_tests_network: "default"        # Sanity-Test 네트워크

# INFLUXDB
influxdb_azs: ["z5"]            # InfluxDB 가용 존
influxdb_instances: 1            # InfluxDB 인스턴스 수
influxdb_vm_type: "large"        # InfluxDB VM 종류
influxdb_network: "default"        # InfluxDB 네트워크
influxdb_persistent_disk_type: "10GB"    # InfluxDB 영구 Disk 종류

# MARIADB
mariadb_azs: ["z5"]            # MariaDB 가용 존
mariadb_instances: 1            # MariaDB 인스턴스 수
mariadb_vm_type: "medium"        # MariaDB VM 종류
mariadb_network: "default"        # MariaDB 네트워크
mariadb_persistent_disk_type: "5GB"    # MariaDB 영구 Disk 종류

# MONITORING-BATCH
monitoring_batch_azs: ["z6"]        # Monitoring-Batch 가용 존
monitoring_batch_instances: 1        # Monitoring-Batch 인스턴스 수
monitoring_batch_vm_type: "small"    # Monitoring-Batch VM 종류
monitoring_batch_network: "default"    # Monitoring-Batch 네트워크

# CAAS-MONITORING-BATCH
caas_monitoring_batch_azs: ["z6"]    # CAAS-Monitoring-Batch 가용 존
caas_monitoring_batch_instances: 1    # CAAS-Monitoring-Batch 인스턴스 수
caas_monitoring_batch_vm_type: "small"    # CAAS-Monitoring-Batch VM 종류
caas_monitoring_batch_network: "default"    # CAAS-Monitoring-Batch 네트워크

# SAAS-MONITORING-BATCH
saas_monitoring_batch_azs: ["z6"]    # SAAS-Monitoring-Batch 가용 존
saas_monitoring_batch_instances: 1    # SAAS-Monitoring-Batch 인스턴스 수
saas_monitoring_batch_vm_type: "small"    # SAAS-Monitoring-Batch VM 종류
saas_monitoring_batch_network: "default"    # SAAS-Monitoring-Batch 네트워크

# MONITORING-WEB
monitoring_web_azs: ["z7"]        # Monitoring-WEB 가용 존
monitoring_web_instances: 1        # Monitoring-WEB 인스턴스 수
monitoring_web_vm_type: "small"        # Monitoring-WEB VM 종류
monitoring_web_network: "default"    # Monitoring-WEB 네트워크

● deploy-paasta-monitoring.sh

$ bosh -e {director_name} -n -d paasta-monitoring deploy paasta-monitoring.yml  \
    -o use-public-network-openstack.yml \
    -o use-compiled-releases-paasta-monitoring.yml \
    -l paasta-monitoring-vars.yml \
    -l ../../common/common_vars.yml

2.4. PaaS-TA Monitoring 설치

• 서버 환경에 맞추어 Deploy 스크립트 파일의 설정을 수정한다.

$ vi ${HOME}/workspace/paasta-5.1/deployment/monitoring-deployment/paasta-monitoring/deploy-paasta-monitoring.sh

$ bosh -e {director_name} -n -d paasta-monitoring deploy paasta-monitoring.yml  \
    -o use-public-network-openstack.yml \
    -l paasta-monitoring-vars.yml \
    -l ../../common/common_vars.yml

• PaaS-TA Monitoring 설치 Shell Script 파일 실행 (BOSH 로그인 필요)

$ cd ${HOME}/workspace/paasta-5.1/deployment/monitoring-deployment/paasta-monitoring
$ sh deploy-paasta-monitoring.sh

2.5. PaaS-TA Monitoring 설치

PaaS-TA Monitoring이 설치 완료 되었음을 확인한다.

$ bosh –e {director_name} vms

3. PaaS-TA Monitoring Dashboard 접속

http://{monitoring_api_url}:8080/public/login.html 에 접속하여 회원 가입 후 Main Dashboard에 접속한다.

Login 화면에서 회원 가입 버튼을 클릭한다.

member_info에는 사용자가 사용할 ID/PWD를 입력하고 하단 paas-info에는 PaaS-TA admin 권한의 계정을 입력한다. PaaS-TA deploy시 입력한 admin/pwd를 입력해야 한다. 입력후 [인증수행]를 실행후 Join버튼을 클릭하면 회원가입이 완료된다.

PaaS-TA Monitoring Main Dashboard 화면