<commit_before><p>
  <center>
    <img src="https://user-images.githubusercontent.com/1423657/39084356-c723a81e-4574-11e8-963c-d11717789fa3.png" width=200/>
  </center>
</p>

# HOMER Seven
#### 100% Open-Source VoIP & RTC Capture, Troubleshooting & Monitoring


![H5](https://img.shields.io/badge/HOMER-7-red.svg)
![HEP](https://img.shields.io/badge/proto-hep_eep-blue.svg)
![HEP](https://img.shields.io/badge/proto-sip-brightgreen.svg)
![HEP](https://img.shields.io/badge/proto-rtcp-brightgreen.svg)
![HEP](https://img.shields.io/badge/proto-rtcp_xr-brightgreen.svg)
![HEP](https://img.shields.io/badge/proto-rtp_stats-brightgreen.svg)
![HEP](https://img.shields.io/badge/text-QoS-green.svg)
![HEP](https://img.shields.io/badge/text-syslog-green.svg)
![HEP](https://img.shields.io/badge/text-CDRs-green.svg)


![ezgif com-optimize 10](https://user-images.githubusercontent.com/1423657/46264200-211a6680-c51a-11e8-8477-3b7a53f9aa0b.gif)

**HOMER** is a robust, carrier-grade, scalable Packet and Event capture system and VoiP/RTC Monitoring Application based on the [HEP/EEP](http://github.com/sipcapture/hep) protocol and ready to process & store insane amounts of signaling, rtc events, logs and statistics with instant search, end-to-end analysis and drill-down capabilities.

**HOMER** is already used by large enterprises, voice network operators, voip service providers and traffic carriers worldwide, has been implemented as a service in 3rd party voice platforms and is suitable for production. 

**HOMER** 7+ is designed and delivered as a set of modular components and building blocks to be used stand-alone or in combination with other platforms.
<br/>

#### :construction: This is a work in progress, the process and instructions might change at any give time.


## :package: Docker Containers
Starting Fresh or Testing? A ready to fire set of [containers](https://github.com/sipcapture/homer7-docker/tree/master/heplify-server) is available in many flavours:

* [HOMER 7](https://github.com/sipcapture/homer/tree/homer7) _development_
  * [HEPlify-Server](https://github.com/sipcapture/homer7-docker/tree/master/heplify-server)
    * [HEPlify + Prometheus ](https://github.com/sipcapture/homer7-docker/tree/master/heplify-server/hom7-hep-prom-graf)
    * [HEPlify + Prometheus + Loki ](https://github.com/sipcapture/homer7-docker/tree/master/heplify-server/hom7-prom-all)
    * [HEPlify + InfluxDB ](https://github.com/sipcapture/homer7-docker/tree/master/heplify-server/hom7-hep-influx) 
    * [HEPlify + InfluxDB + LoudML](https://github.com/sipcapture/homer7-docker/tree/master/heplify-server/hom7-hep-influx)
    * [HEPlify + Elastic ](https://github.com/sipcapture/homer7-docker/tree/master/heplify-server/hom7-hep-elastic) 
    * [HEPlify + Elastic Headless](https://github.com/sipcapture/homer7-docker/tree/master/heplify-server/hom7-elastic)
    
  * [HEPop Server](https://github.com/sipcapture/homer7-docker/tree/master/hepop)
    * [HEPop + InfluxDB](https://github.com/sipcapture/homer7-docker/tree/master/hepop/hom7-hep-influx)
    * [HEPop + InfluxDB + LoudML](https://github.com/sipcapture/homer7-docker/tree/master/hepop/hom7-loudml-influx)
    * [HEPop + Loki ](https://github.com/sipcapture/homer7-docker/tree/master/hepop/hom7-json-loki)
    * [HEPop + PGSql + InfluxDB ](https://github.com/sipcapture/homer7-docker/tree/master/hepop/hom7-json-influx)
    * [HEPop + Elastic ](https://github.com/sipcapture/homer7-docker/tree/master/hepop/hom7-elastic-only)

* [HOMER 5](https://github.com/sipcapture/homer/tree/homer5) _legacy_
  * [HEPlify-Server](https://github.com/sipcapture/homer-docker/tree/master/heplify-server)
    * [HEPlify-S + Prometheus ](https://github.com/sipcapture/homer-docker/tree/master/heplify-server/hom5-hep-prom-graf)
    * [HEPlify-S + InfluxDB ](https://github.com/sipcapture/homer-docker/tree/master/heplify-server/hom5-hep-influx)
    * [HEPlify-S + Elasticsearch ](https://github.com/sipcapture/homer-docker/tree/master/heplify-server/hom5-hep-elastic)
    
  * [OpenSIPS + sipcapture](https://github.com/sipcapture/homer-docker/tree/master/opensips-everything)
  * [Kamailio + sipcapture](https://github.com/sipcapture/homer-docker/tree/master/kamailio)
  
  
## :construction: Installation
Unlike its predecessors, HOMER Seven is completely dynamic, meaning there are many database, timeseries and logging backend combinations possible. Before installing the user should determine preferences and settings for each component. 

#### :warning: Requirements
* API + UI
  * NodeJS 8.x+
* DATA STORAGE (choose one)
  * Postgres 9.x
  * Elasticsearch
  * Loki
* TIMESERIES (choose one)
  * InfluxDB
  * Prometheus
  * Elasticsearch

#### :package: Deploy HEP Capture Server (CS)
Install a HEP Capture Server based on your needs and preferences:
* **HEPlify-server**
  :o: CS developed in go, ideal for heavy HEP packet loads
* **HEPop**: 
  :o: CS developed in nodejs, ideal for RTC events and JSON streams

  * Configure HEP sockets
  * Configure connectivity to DB and Timeseries DB

#### :package: Deploy a HOMER webapp
Install the Homer App
* **HOMER-APP**
  :o: API + UI developed in nodejs, self-served
  
  * Configure connectivity to DB and Timeseries DB
  * Configure user access preferences

#### :package: Deploy a Capture Agent (CA)
Install a HEP Capture Agent based on your needs and preferences:
* **HEPlify**
  :o: CA developed in go, portable, near zero configuration
* **CaptAgent**: 
  :o: CA developed in C, ideal for complex configurations
  
  * Configure Capture settings
  * Configure connectivity to HEP server
  
* **Native**
  :o: Native HEP Agents in OpenSIPS, Kamailio, Asterisk, Freeswitch, RTP:Engine and more
----------------

### Support
For professional support, remote installations, customizations or commercial requests please contact: <EMAIL>

For community support, updates, user discussion and experience exchange please join our users   [Mailing-List](https://groups.google.com/forum/#!forum/homer-discuss)

For commercial licensing and support, please contact the QXIP Team at [http://qxip.net]

<img src="http://i.imgur.com/9AN08au.gif" width=100% height=50 >



### Developers
Contributors and Contributions to our project are always welcome! If you intend to participate and help us improve HOMER by sending patches, we kindly ask you to sign a standard [CLA (Contributor License Agreement)](http://cla.qxip.net) which enables us to distribute your code alongside the project without restrictions present or future. It doesn’t require you to assign to us any copyright you have, the ownership of which remains in full with you. Developers can coordinate with the existing team via the [homer-dev](http://groups.google.com/group/homer-dev) mailing list. If you'd like to join our internal team and volounteer to help with the project's many needs, feel free to contact us anytime!


### License & Copyright

![H5](https://img.shields.io/badge/license-GNU_AGPL_v3-blue.svg)

Homer components are released under the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

*(C) 2008-2018 [QXIP BV](http://qxip.net)*

----------

#### Made by Humans
This Open-Source project is made possible by actual Humans without corporate sponsors, angels or patreons.<br>
If you use this software in production, please consider supporting its development with contributions or [donations](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=donation%40sipcapture%2eorg&lc=US&item_name=SIPCAPTURE&no_note=0&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest)

[![Donate](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=donation%40sipcapture%2eorg&lc=US&item_name=SIPCAPTURE&no_note=0&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest) 
<commit_msg>new logo<commit_after><img src="https://user-images.githubusercontent.com/1423657/55069501-8348c400-5084-11e9-9931-fefe0f9874a7.png" width=400/>

# HOMER Seven
#### 100% Open-Source VoIP & RTC Capture, Troubleshooting & Monitoring


![H5](https://img.shields.io/badge/HOMER-7-red.svg)
![HEP](https://img.shields.io/badge/proto-hep_eep-blue.svg)
![HEP](https://img.shields.io/badge/proto-sip-brightgreen.svg)
![HEP](https://img.shields.io/badge/proto-rtcp-brightgreen.svg)
![HEP](https://img.shields.io/badge/proto-rtcp_xr-brightgreen.svg)
![HEP](https://img.shields.io/badge/proto-rtp_stats-brightgreen.svg)
![HEP](https://img.shields.io/badge/text-QoS-green.svg)
![HEP](https://img.shields.io/badge/text-syslog-green.svg)
![HEP](https://img.shields.io/badge/text-CDRs-green.svg)


![ezgif com-optimize 10](https://user-images.githubusercontent.com/1423657/46264200-211a6680-c51a-11e8-8477-3b7a53f9aa0b.gif)

**HOMER** is a robust, carrier-grade, scalable Packet and Event capture system and VoiP/RTC Monitoring Application based on the [HEP/EEP](http://github.com/sipcapture/hep) protocol and ready to process & store insane amounts of signaling, rtc events, logs and statistics with instant search, end-to-end analysis and drill-down capabilities.

**HOMER** is already used by large enterprises, voice network operators, voip service providers and traffic carriers worldwide, has been implemented as a service in 3rd party voice platforms and is suitable for production. 

**HOMER** 7+ is designed and delivered as a set of modular components and building blocks to be used stand-alone or in combination with other platforms.
<br/>

#### :construction: This is a work in progress, the process and instructions might change at any give time.


## :package: Docker Containers
Starting Fresh or Testing? A ready to fire set of [containers](https://github.com/sipcapture/homer7-docker/tree/master/heplify-server) is available in many flavours:

* [HOMER 7](https://github.com/sipcapture/homer/tree/homer7) _development_
  * [HEPlify-Server](https://github.com/sipcapture/homer7-docker/tree/master/heplify-server)
    * [HEPlify + Prometheus ](https://github.com/sipcapture/homer7-docker/tree/master/heplify-server/hom7-hep-prom-graf)
    * [HEPlify + Prometheus + Loki ](https://github.com/sipcapture/homer7-docker/tree/master/heplify-server/hom7-prom-all)
    * [HEPlify + InfluxDB ](https://github.com/sipcapture/homer7-docker/tree/master/heplify-server/hom7-hep-influx) 
    * [HEPlify + InfluxDB + LoudML](https://github.com/sipcapture/homer7-docker/tree/master/heplify-server/hom7-hep-influx)
    * [HEPlify + Elastic ](https://github.com/sipcapture/homer7-docker/tree/master/heplify-server/hom7-hep-elastic) 
    * [HEPlify + Elastic Headless](https://github.com/sipcapture/homer7-docker/tree/master/heplify-server/hom7-elastic)
    
  * [HEPop Server](https://github.com/sipcapture/homer7-docker/tree/master/hepop)
    * [HEPop + InfluxDB](https://github.com/sipcapture/homer7-docker/tree/master/hepop/hom7-hep-influx)
    * [HEPop + InfluxDB + LoudML](https://github.com/sipcapture/homer7-docker/tree/master/hepop/hom7-loudml-influx)
    * [HEPop + Loki ](https://github.com/sipcapture/homer7-docker/tree/master/hepop/hom7-json-loki)
    * [HEPop + PGSql + InfluxDB ](https://github.com/sipcapture/homer7-docker/tree/master/hepop/hom7-json-influx)
    * [HEPop + Elastic ](https://github.com/sipcapture/homer7-docker/tree/master/hepop/hom7-elastic-only)

* [HOMER 5](https://github.com/sipcapture/homer/tree/homer5) _legacy_
  * [HEPlify-Server](https://github.com/sipcapture/homer-docker/tree/master/heplify-server)
    * [HEPlify-S + Prometheus ](https://github.com/sipcapture/homer-docker/tree/master/heplify-server/hom5-hep-prom-graf)
    * [HEPlify-S + InfluxDB ](https://github.com/sipcapture/homer-docker/tree/master/heplify-server/hom5-hep-influx)
    * [HEPlify-S + Elasticsearch ](https://github.com/sipcapture/homer-docker/tree/master/heplify-server/hom5-hep-elastic)
    
  * [OpenSIPS + sipcapture](https://github.com/sipcapture/homer-docker/tree/master/opensips-everything)
  * [Kamailio + sipcapture](https://github.com/sipcapture/homer-docker/tree/master/kamailio)
  
  
## :construction: Installation
Unlike its predecessors, HOMER Seven is completely dynamic, meaning there are many database, timeseries and logging backend combinations possible. Before installing the user should determine preferences and settings for each component. 

#### :warning: Requirements
* API + UI
  * NodeJS 8.x+
* DATA STORAGE (choose one)
  * Postgres 9.x
  * Elasticsearch
  * Loki
* TIMESERIES (choose one)
  * InfluxDB
  * Prometheus
  * Elasticsearch

#### :package: Deploy HEP Capture Server (CS)
Install a HEP Capture Server based on your needs and preferences:
* **HEPlify-server**
  :o: CS developed in go, ideal for heavy HEP packet loads
* **HEPop**: 
  :o: CS developed in nodejs, ideal for RTC events and JSON streams

  * Configure HEP sockets
  * Configure connectivity to DB and Timeseries DB

#### :package: Deploy a HOMER webapp
Install the Homer App
* **HOMER-APP**
  :o: API + UI developed in nodejs, self-served
  
  * Configure connectivity to DB and Timeseries DB
  * Configure user access preferences

#### :package: Deploy a Capture Agent (CA)
Install a HEP Capture Agent based on your needs and preferences:
* **HEPlify**
  :o: CA developed in go, portable, near zero configuration
* **CaptAgent**: 
  :o: CA developed in C, ideal for complex configurations
  
  * Configure Capture settings
  * Configure connectivity to HEP server
  
* **Native**
  :o: Native HEP Agents in OpenSIPS, Kamailio, Asterisk, Freeswitch, RTP:Engine and more
----------------

### Support
For professional support, remote installations, customizations or commercial requests please contact: <EMAIL>

For community support, updates, user discussion and experience exchange please join our users   [Mailing-List](https://groups.google.com/forum/#!forum/homer-discuss)

For commercial licensing and support, please contact the QXIP Team at [http://qxip.net]

<img src="http://i.imgur.com/9AN08au.gif" width=100% height=50 >



### Developers
Contributors and Contributions to our project are always welcome! If you intend to participate and help us improve HOMER by sending patches, we kindly ask you to sign a standard [CLA (Contributor License Agreement)](http://cla.qxip.net) which enables us to distribute your code alongside the project without restrictions present or future. It doesn’t require you to assign to us any copyright you have, the ownership of which remains in full with you. Developers can coordinate with the existing team via the [homer-dev](http://groups.google.com/group/homer-dev) mailing list. If you'd like to join our internal team and volounteer to help with the project's many needs, feel free to contact us anytime!


### License & Copyright

![H5](https://img.shields.io/badge/license-GNU_AGPL_v3-blue.svg)

Homer components are released under the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

*(C) 2008-2018 [QXIP BV](http://qxip.net)*

----------

#### Made by Humans
This Open-Source project is made possible by actual Humans without corporate sponsors, angels or patreons.<br>
If you use this software in production, please consider supporting its development with contributions or [donations](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=donation%40sipcapture%2eorg&lc=US&item_name=SIPCAPTURE&no_note=0&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest)

[![Donate](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=donation%40sipcapture%2eorg&lc=US&item_name=SIPCAPTURE&no_note=0&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest) 

{'fraction_non_alphanumeric': 0.12808748664445982, 'fraction_numerical': 0.019734774684180754, 'mean_word_length': 4.756874095513748, 'pattern_counts': {'":': 0, '<': 17, '<?xml version=': 0, '>': 17, 'https://': 76, 'lorem ipsum': 0, 'www.': 6, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '846131', 'n_tokens_mistral': 5660, 'n_tokens_neox': 5208, 'n_words': 1267}