{"id":31608702,"url":"https://github.com/roflaff/sentinel","last_synced_at":"2025-10-06T08:23:48.411Z","repository":{"id":312228203,"uuid":"1046748948","full_name":"Roflaff/Sentinel","owner":"Roflaff","description":"System Logging(CPU, GPU, DISK) \u0026 Langfuse integration ","archived":false,"fork":false,"pushed_at":"2025-09-09T05:49:28.000Z","size":352,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-09T08:31:42.211Z","etag":null,"topics":["cpu-monitoring","gpu-monitoring","grafana","langfuse","logging","prometheus","system"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Roflaff.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-29T06:54:26.000Z","updated_at":"2025-09-02T02:22:13.000Z","dependencies_parsed_at":"2025-08-29T11:15:51.245Z","dependency_job_id":"c6b22305-8754-4655-933e-caebb4353dfc","html_url":"https://github.com/Roflaff/Sentinel","commit_stats":null,"previous_names":["roflaff/sentinel"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Roflaff/Sentinel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Roflaff%2FSentinel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Roflaff%2FSentinel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Roflaff%2FSentinel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Roflaff%2FSentinel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Roflaff","download_url":"https://codeload.github.com/Roflaff/Sentinel/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Roflaff%2FSentinel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278578131,"owners_count":26009739,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-06T02:00:05.630Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cpu-monitoring","gpu-monitoring","grafana","langfuse","logging","prometheus","system"],"created_at":"2025-10-06T08:23:46.036Z","updated_at":"2025-10-06T08:23:48.391Z","avatar_url":"https://github.com/Roflaff.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sentinel\n\n이 프로젝트는 [Prometheus](https://prometheus.io/)와 [Grafana](https://grafana.com/)를 사용하여 시스템 및 애플리케이션 메트릭을 모니터링하고 시각화하는 대시보드 시스템입니다.\n\n## 아키텍처\n- Prometheus + Grafana\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./docs/architecture.png\" alt=\"Sentinel Architecture\" width=\"600\"/\u003e\n\u003c/p\u003e\n\n\n## 선행 조건 (Prerequisites)\n\n**중요:** 이 프로젝트를 실행하기 전에, 의존성이 있는 선행 프로젝트가 반드시 실행 중이어야 합니다. 이 프로젝트는 선행 프로젝트와 동일한 외부 Docker 네트워크에 연결되어야 정상적으로 작동합니다.\n\n### 필요 소프트웨어\n\n*   [Docker](https://www.docker.com/get-started)\n*   [Docker Compose](https://docs.docker.com/compose/install/)\n\n## 시작하기 (Getting Started)\n\n1.  **리포지토리 클론**\n    ```bash\n    git clone https://github.com/Roflaff/Sentinel.git\n    cd Sentinel\n    ```\n\n2.  **환경 변수 설정**\n    프로젝트 루트 디렉터리에 `.env` 파일을 생성하고, `docker-compose.yml`에서 사용할 외부 네트워크 이름을 지정합니다.\n\n    - find network name:\n\n    ```bash\n    docker network ls\n    NETWORK ID     NAME                                        DRIVER    SCOPE\n    ...\n    ```\n    \n    - `.env`:\n    ```\n    EXTERNAL_NETWORK_NAME=your_external_network_name\n    ```\n    `your_external_network_name`을 선행 프로젝트에서 사용하는 네트워크 이름으로 변경해주세요.\n\n3.  **프로젝트 실행**\n    아래 명령어를 사용하여 Docker Compose로 프로젝트를 시작합니다.\n    ```bash\n    docker-compose up -d\n    ```\n\n## 서비스 접속\n\n*   **Prometheus**\n    *   URL: [http://localhost:19090](http://localhost:19090)\n    *   Prometheus 대시보드 및 메트릭 수집 상태를 확인할 수 있습니다.\n\n*   **Grafana -\u003e MAIN**\n    *   URL: [http://localhost:13030](http://localhost:13030)\n    *   초기 로그인 정보:\n        *   Username: `admin`\n        *   Password: `admin`\n    *   로그인 후 비밀번호를 변경하는 것을 권장합니다.\n    *   데이터 불러오기 확인 및 대시보드 설정은 다음 링크를 참고합니다.\n    *   Ref: TODO:\n\n## 설정 (Configuration)\n\n### Prometheus 타겟 설정\n\nPrometheus가 수집할 메트릭 소스(타겟)를 변경하려면 `conf/prometheus.yml` 파일을 수정하세요. 해당 네트워크에서 실행되고 있는 포트에 접근합니다.\n\n```yaml\nscrape_configs:\n  - job_name: node-exporter\n    metrics_path: /metrics\n    static_configs:\n      - targets: ['node-exporter:9090']\n  \n  # 여기에 새로운 타겟을 추가할 수 있습니다.\n  # - job_name: 'my-app'\n  #   static_configs:\n  #   metrics_path: /metrics\n  #     - targets: ['host.docker.internal:8080']\n```\n\n설정 변경 후에는 아래 명령어로 서비스를 재시작해야 합니다.\n```bash\ndocker-compose restart prometheus\n```\n\n## 기여하기 (Contributing)\n\n이 프로젝트에 기여하고 싶으시다면, `.github` 디렉터리에 있는 `ISSUE_TEMPLATE`과 `pull_request_template.md`를 참고하여 이슈를 생성하거나 풀 리퀘스트를 보내주세요.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froflaff%2Fsentinel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froflaff%2Fsentinel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froflaff%2Fsentinel/lists"}