> 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) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET 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?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.