Monthly [BeCloud Internal Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Monthly ======

===== Introduction =====
Every start of the month, it is necessary to perform various tasks, which may vary due to them being different. \\
Currently, the ones that I've ([[antonio.andriychuk@becloudsolutions.com|Antonio Andriychuk]]) been following and being involved with are:
  * Concurrent Usage;
  * Concurrent Calls for the Lario Reti Holding tenant;
  * CDRs;

Usually, I always started with the concurrent calls since they're easy to do and also because, contractually speaking, they must be sent every start of each month. \\ \\

===== Concurrent Calls for Lario Reti =====
On the first day of every month at 8 A.M. UTC, a cronjob scheduled in the machine named "Monitoring" runs a script that automatically retrieves the graph from Grafana showing the concurrent calls of the previous month and sends an email with the updated data in the tables.
===== Concurrent Usage =====
As per the Concurrent Usage, I'm more than happy to let you know that I've developed a script for it! :) \\
In order to run the script you need something beforehand:
  * To install Python on your device (from 3.12 >): https://www.python.org/downloads/;
  * To install Python-Pandas: https://pandas.pydata.org/;
  * Download my script: [[concurrentusage:index]]

**__If it's your first time doing this procedure, you must first create a folder in your pc where you can store the usages files and the script. Once done that, proceed with the next step.__**

The procedure goes as follows:
  - Go to the sysmgmt page of the region (FK or SYD), to "Usage" and click on "Concurrent Users License Report 3 months" to download the usage;
  - Extract the file onto the folder where the .py script is located;
  - Ensure that the file is named as "license_usage_report.csv";
  - Launch the .py script;
  - The only input from the user will be to declare whether it's Frankfurt or Sydney;
  - Then, you will be printed with "This is the max -->" and a value, you must pass this file to whom's following the Usage update, and if you want you can even hand them the usage_(month)_(year)_(region).csv file, which is already parsed with the correct month;
  - Repeat the process with the next region;

As you could've guessed, this one was an oddly easy task, and with the help of my script, you perform it in a matter of seconds. \\ \\

===== CDRs =====
This topic is rather important since it involves an economic value for the company. And guess what? I've developed a script for this part as well! :) \\

\\
Download links for all CDRs:
  * [[https://insights.voxbone.com/|Voxbone]] --> Click on "DOWNLOAD CSV" and select month time range
  * [[https://cdr.irideos.it/reserved/home|Irideos]] --> Click on the only folder, then select the interested month and click "download"
  * [[https://envision.gtt.net/billing-invoice|GTT]] --> download the .csv of the interested month
  * [[https://portal.telnyx.com/#/reporting/detailed-records|Telnyx]] --> TODO LORENZO
  * [[https://my.colt.net/billing/#/grid|Colt]] --> TODO LORENZO
\\

The required tools are the same as specified in the Concurrent Usage tab, thus you need the script in order to run the code, which can be downloaded from the following link:
  * CDRs code: [[cdrs:index]] \\ 

My best advice is to create a Master folder for the year (Eg. 2024) and inside create a Month folder everytime you have to handle this task. So, inside the 2024 folder you can create for example an "April" folder where you can work on. \\
Proceed with creating the carrier folders (Voxbone / GTT / Irideos) and by downloading them through the Carrier's portal you have to save the .csv files on the folder for each carrier:
  * In the Voxbone folder: you have to save the file as "cdrs.csv";
  * In the GTT folder: you have to save the file as "cdrs.csv";
  * In the Irideos folder: you have to create two files, one called "cdrs.csv" for outbound (the one that ends with ...38) and "cdrs_green.csv" for the toll-free traffic(the one that ends with ...39);

Specifically for Irideos, __I have a few tips__: \\ 
Once you've downloaded the file and extract them, you will obtain two folders as previously noted:
  * if you use unix (MacOS or Linux) go inside the folder (for example the one that ends with ...38) and do this command: <code bash>cat 90* > cdrs.csv && mv cdrs.csv ../../ </code> to save the file in the correct folder;
  * if you use Windows (download [[https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.4#install-powershell-using-winget-recommended|Powershell 7]]) go inside the folder (for example the one that ends with ...38) and do this command: <code bash>cat 90* > cdrs.csv && mv cdrs.csv ../../ </code> to save the file in the correct folder;
\\
Then you can proceed with running the Python script, it will ask for an input regarding GTT to be extrapulated as well then you will receive in your terminal the values divided per each customer.\\
The next step is to store the "**Reselling Cost**" data in the [[https://docs.google.com/spreadsheets/d/1yTjXipu9NEHD21jLWteb6nDszzZonydV/edit?gid=692771078#gid=692771078|Master Traffico Ricariche]] spreadsheet, in the desired month and per each customer.\\
After, you will have to follow this procedure on the monitor:
  - Go to the [[https://monitor.ccaas.becloudsolutions.com:3000/d/wMoz45sWz/traffic-situation?orgId=1|Monitor "Traffic Situation" page]]
  - Click on the interested tenant and select "Edit"
  - In the query editor you can see that there is a calculation: the first number is the recharge that Stefano will communicate to you (this is not monthly, a customer could be recharging every n month for example, you need to update this number **only if** it is communicated to you) and you also have to update it on the [[https://docs.google.com/spreadsheets/d/1yTjXipu9NEHD21jLWteb6nDszzZonydV/edit?gid=692771078#gid=692771078|shared spreadsheet]] and the second is the total traffic for the previous months. *BOTH NUMBERS ARE CUMULATIVE*, that means that at the start of the month (or 15 of the month for GTT) you need to add the total costs to the second number, and whenever Stefano communicate to you a recharge (it could be whenever during the month) you need to add the amount to the first number 

\\
In the [[https://monitor.ccaas.becloudsolutions.com:3000/d/wMoz45sWz/traffic-situation?orgId=1|monitor]], I strongly advise you to disable every [[https://monitor.ccaas.becloudsolutions.com:3000/alerting/list|alarm]] before performing any changes. Once you've secured that every alarm has been disabled you can proceed to open each window and change the first value of the query with the total gathered from the spreadsheet and save. \\ \\
The next step will be to access (SSH) to the monitor machine and navigate to the __**/home/centos/monitorTraffic**__ folder and open the calculate.js file to change the month with the current one (variable "month" at line 25) in the format YYYY-MM-DD, then proceed with running the script with <code bash> node calculate.js </code> and wait until it finishes. \\ \\
After, you will have to wait until you see that in the Traffic Situation monitor **__the values has been changed before restarting the alerts.__** \\ \\

The next steps will take you some time, which is to deliver the Carrier Costs and Reselling Costs to [[mailto:admin@becloudsolutions.com|Admin]] **for each customer**... Feel free to use this E-Mail as an example:
<code>
Ciao Stefano,
Di seguito il traffico telefonico erogato per E80 nel mese di Settembre 2024:

Trunk Irideos Numero verde:         Fatturato: € 167.07 -  ( Costo a noi: € 97.73 )
Trunk Irideos Outbound :            Fatturato: € 152.97 -  ( Costo a noi: € 77.94 )

Trunk VoxBone Numero Verde:         Fatturato: € 56.4 -  ( Costo a noi: € 35.15 )
Trunk VoxBone Outbound:             Fatturato: € 622.82 -  ( Costo a noi: € 39.46 )

Totale: 
Costo a noi: € 250.28
Fatturato:   € 999.26
Come da accordi, provvederemo ad inoltrare il CRD a E80 da VoiceTraffic.

Saluti,
Antonio A.
</code>

**__Be aware that only on the tenant Omega3C - Microdata you have to attach the .csv file__**  \\

The last step to do is to deliver an Email from Voicetraffic to these customers:
  * Farmacie Italiane ([[mailto:andrea.durante@gruppofarmacieitaliane.it|Andrea Durante]], [[mailto:umberto.gallo@gruppofarmacieitaliane.it|Umberto Gallo]]);
  * Ingo-LRH ([[mailto:davide.signorelli@ingogroup.it|Davide Signorelli]], [[mailto:luana.beni@ingogroup.it|Luana Beni]]);
  * E80 ([[mailto:fatture@elettric80.it|Fatture E80]]);
  * BeEasy ([[mailto:m.rocchi@beeasy.cloud|Matteo Rocchi]]);
Only after you will receive the GTT file you have to send the CDR (with our prices) to this customer:
  * RedSun ([[mailto:ict@arquati.it|ICT]]);

You will find every data, as well as a template on the sent item of that same mailbox.

 --- //[[antonio.andriychuk@becloudsolutions.com|Antonio Andriychuk]] 2024/10/08 13:28//