Metadata-Version: 2.1
Name: noted-dev
Version: 1.1.23
Summary: NOTED: a framework to optimise network traffic via the analysis of data from File Transfer Services
Home-page: https://gitlab.cern.ch/mmisamor/noted
Author: Carmen Misa Moreira, Edoardo Martelli (CERN IT-CS-NE)
Author-email: carmen.misa.moreira@cern.ch
License: GPLv3 (GNU General Public License)
Project-URL: Source, https://gitlab.cern.ch/mmisamor/noted
Description: # NOTED: a framework to optimise network traffic via the analysis of data from File Transfer Services
        
        Copyright:
        ```
        © Copyright 2022 CERN. This software is distributed under the terms of
        the GNU General Public Licence version 3 (GPL Version 3), copied verbatim
        in the file "LICENCE.txt". In applying this licence, CERN does not waive
        the privileges and immunities granted to it by virtue of its status as an
        Intergovernmental Organization or submit itself to any jurisdiction.
        ```
        
        Compilation steps:
        ```
        # Steps to install NOTED using a virtual environment:
        ubuntu@pr1:~$ pip3 install virtualenv 
        ubuntu@pr1:~$ python3 -m venv venv-noted
        ubuntu@pr1:~$ . venv-noted/bin/activate
        (venv-noted) ubuntu@pr1:~$ python3 -m pip install noted-dev
        # In this step you will be ask to enter your authentication token
        # Write your configuration file, there is one example in noted/config/
        (venv-noted) ubuntu@pr1:~$ nano noted/config/config.yaml
        # Run NOTED
        # (venv-noted) ubuntu@pr1:~$ noted noted/config/config.yaml [--verbosity debug/info/warning]
        ```
        
        Program description:
        ```
        noted -h
        usage: noted [-h] [-v VERBOSITY] config_file
        
        NOTED: a framework to optimise network traffic via the analysis of data from File Transfer Services.
        
        positional arguments:
          config_file           the name of the configuration file [config-example.yaml]
        
        optional arguments:
          -h, --help            show this help message and exit
          -v VERBOSITY, --verbosity VERBOSITY
                                defines the logging level [debug, info, warning]
        ```
        
        Folder structure of NOTED:
        1. In config folder is available one or more config.yaml where the user defines the parameters to monitor the links.
        2. In logs folder:
            noted_email.txt: the last email notification that has been send to the responsible of the link to provide/cancel the dynamic circuit.
            transfer_broker.log: the log of NOTED [one log per execution].
            sense.log: the log of sense-o, it is generated when NOTED calls the sense-o API [one log per execution].
        3. In query folder are available the queries to CERN Kibana [this folder is transparent to the user, don't use it].
        4. In transfers folder:
            transfer_broker_all_transfers.txt: file with all the transfers in the link even if the source/destination dynamic circuits are down.
            transfer_broker_src_rcsite.txt: file with the transfers of {src -> dst}  when the source dynamic circuit is up, otherwise the transfers are not saved.
            transfer_broker_dst_rcsite.txt: file with the transfers of {dst -> src}  when the destination dynamic circuit is up, otherwise the transfers are not saved.
        ```
        noted
        ├── config
        │   └── config.yaml
        ├── logs
        │   ├── noted_email.txt
        │   └── sense.log
        │   └── transfer_broker.log
        ├── params
        │   └── params.ini
        ├── query
        │   ├── query_monit_prod_fts_raw_queue_dst_rcsite
        │   └── query_monit_prod_fts_raw_queue_src_rcsite
        ├── sense-o
        │   │   ├── sense-cancel.sh
        │   │   └── sense-provision.sh
        └── transfers
            ├── transfer_broker_all_transfers.txt
            ├── transfer_broker_dst_rcsite.txt
            └── transfer_broker_src_rcsite.txt
        ```
        
        Structure of NOTED repository:
        ```
        .
        ├── README.md
        └── noted_transfer_broker
            ├── COPYRIGHT.txt
            ├── LICENCE.txt
            ├── Makefile
            ├── MANIFEST.in
            ├── README.md
            ├── setup.cfg
            ├── setup.py
            └── src
                ├── noted
                    ├── __init__.py
                    ├── main.py
                    ├── config
                    │   └── config-example.yaml
                    ├── documentation
                    │   ├── noted_main_function_documentation.pdf
                    │   ├── noted_transfer_broker_class_documentation.pdf
                    │   ├── reduced_noted_main_function_documentation.pdf
                    │   └── reduced_noted_transfer_broker_class_documentation.pdf
                    ├── html
                    │   ├── TransferBroker.html
                    │   └── main.html
                    ├── logs
                    │   ├── noted_email.txt
                    │   ├── sense.log
                    │   ├── transfer_broker.log
                    ├── modules
                    │   ├── __init__.py
                    │   ├── plot_transfers.py
                    │   └── transferbroker.py
                    ├── params
                    │   └── params.ini
                    ├── query
                    │   ├── query_monit_prod_fts_raw_queue_dst_rcsite
                    │   └── query_monit_prod_fts_raw_queue_src_rcsite
                    ├── scripts
                    │   └── setup.sh
                    ├── sense-o
                    │   ├── sense-cancel.sh
                    │   └── sense-provision.sh
                    └── transfers
                        ├── transfer_broker_all_transfers.txt
                        ├── transfer_broker_dst_rcsite.txt
                        └── transfer_broker_src_rcsite.txt
        ```
        
Keywords: networking,monitoring,transfers,throughput,dynamic circuit,load balance,fts,sense-o
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Natural Language :: English
Classifier: Topic :: System :: Networking :: Monitoring
Requires-Python: >=3
Description-Content-Type: text/markdown
