> For the complete documentation index, see [llms.txt](https://paastaguide.gitbook.io/paas-ta-5-5-0/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://paastaguide.gitbook.io/paas-ta-5-5-0/guide-5.5.0-semini/service-guide/monitoring/paas-ta_monitoring_paas-ta_monitoring_install.md). # PaaS-TA Monitoring 설치 가이드 ## Table of Contents 1\. [개요](/paas-ta-5-5-0/guide-5.5.0-semini/service-guide/monitoring/paas-ta_monitoring_paas-ta_monitoring_install.md#1)\ 2\. [PaaS-TA Monitoring 설치](/paas-ta-5-5-0/guide-5.5.0-semini/service-guide/monitoring/paas-ta_monitoring_paas-ta_monitoring_install.md#2)\ 2.1. [Prerequisite](/paas-ta-5-5-0/guide-5.5.0-semini/service-guide/monitoring/paas-ta_monitoring_paas-ta_monitoring_install.md#3)\ 2.2. [설치 파일 다운로드](/paas-ta-5-5-0/guide-5.5.0-semini/service-guide/monitoring/paas-ta_monitoring_paas-ta_monitoring_install.md#4)\ 2.3. [PaaS-TA Monitoring 설치 환경설정](/paas-ta-5-5-0/guide-5.5.0-semini/service-guide/monitoring/paas-ta_monitoring_paas-ta_monitoring_install.md#5)\ ∙ [common\_vars.yml](/paas-ta-5-5-0/guide-5.5.0-semini/service-guide/monitoring/paas-ta_monitoring_paas-ta_monitoring_install.md#6)\ ∙ [paasta-monitoring-vars.yml](/paas-ta-5-5-0/guide-5.5.0-semini/service-guide/monitoring/paas-ta_monitoring_paas-ta_monitoring_install.md#7)\ ∙ [deploy-paasta-monitoring.sh](/paas-ta-5-5-0/guide-5.5.0-semini/service-guide/monitoring/paas-ta_monitoring_paas-ta_monitoring_install.md#8)\ 2.4. [PaaS-TA Monitoring 설치](/paas-ta-5-5-0/guide-5.5.0-semini/service-guide/monitoring/paas-ta_monitoring_paas-ta_monitoring_install.md#9)\ 2.5. [서비스 설치 확인](/paas-ta-5-5-0/guide-5.5.0-semini/service-guide/monitoring/paas-ta_monitoring_paas-ta_monitoring_install.md#10)\ 3\. [PaaS-TA Monitoring Dashboard 접속](/paas-ta-5-5-0/guide-5.5.0-semini/service-guide/monitoring/paas-ta_monitoring_paas-ta_monitoring_install.md#11) ## 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: "aaa@naver.com" # 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 ``` ![](/files/-MUwQUJLj_O5CMu3E7py) ## 3. PaaS-TA Monitoring Dashboard 접속 에 접속하여 회원 가입 후 Main Dashboard에 접속한다. Login 화면에서 회원 가입 버튼을 클릭한다. ![](/files/-MUwQUJNrCqj8aAbjv6n) member\_info에는 사용자가 사용할 ID/PWD를 입력하고 하단 paas-info에는 PaaS-TA admin 권한의 계정을 입력한다.\ PaaS-TA deploy시 입력한 admin/pwd를 입력해야 한다.\ 입력후 \[인증수행]를 실행후 Join버튼을 클릭하면 회원가입이 완료된다. ![](/files/-MUwQUJPy8FjSbUgF2Mn) PaaS-TA Monitoring Main Dashboard 화면 ![](/files/-MUwQUJSIjXn4d4STp_I)