@@ -8,56 +8,41 @@ This project is a secure, lightweight SaaS-like database latency testing GUI and
8
8
9
9
![ Screenshot 2025-07-03 at 11 26 30 PM] ( https://github.com/user-attachments/assets/f1b17fb8-f637-4b86-95c9-52dd0b6e2067 )
10
10
11
- ## Databases Supported 🔌 :
12
-
13
- ### Oracle DB >= 12.2 📌 :
14
- - Amazon RDS Oracle
15
- - OCI Autonomous Database
16
- - OCI VMDB
17
- - OCI Exadata Cloud Service
18
- - Oracle Database On-Premise
19
-
20
- ### Postgres >= 11 📌 :
21
- - Amazon RDS Postgres
22
- - Amazon RDS Aurora Postgres
23
- - Postgres On-premise
24
-
25
- ### MySQL >= 5.7 📌 :
26
- - Amazon RDS MySQL
27
- - Amazon RDS Aurora MySQL
28
- - OCI MySQL Database Service
29
- - OCI MySQL Heatwave
30
- - MySQL On-Premise
31
-
32
- ### URL - HTTPS | HTTP 📌 :
33
- - Check Public or Private URLs for latency
11
+ ### 1. Clone Repository ###
12
+ ``` bash
13
+ git clone https://github.com/oracle-quickstart/db-endpoint-latency-testing-ammeter.git && cd db-endpoint-latency-testing-ammeter/
14
+ ```
34
15
16
+ ### 2. Create a Python Virtual Environment
35
17
36
- ### 1. Create a Python Virtual Environment
37
18
``` bash
38
19
python3 -m venv .venv
20
+
39
21
# Activate on Unix/macOS:
40
22
source .venv/bin/activate
23
+
41
24
# Activate on Windows:
42
25
.venv\S cripts\a ctivate
43
26
```
44
- ### 2. Install requirements
27
+
28
+ ### 3. Install requirements
45
29
``` bash
46
- pip install -r requirements.txt
30
+ pip3 install -r requirements.txt
47
31
```
48
- ### 3. Launch the Web App
32
+
33
+ ### 4. Launch the Web App
49
34
``` bash
50
35
uvicorn app.main:app --host 0.0.0.0 --port 8000
51
36
```
52
- ### 4 . Open your browser at:
37
+ ### 5 . Open your browser at:
53
38
```
54
39
http://localhost:8000
55
40
```
56
41
- Log in: ` admin ` / ` change_this ` (update password in ` app/main.py ` for production).
57
42
- Fill out the form and run latency tests in real time with live chart and table views.
58
43
- For any errors (connection, authentication) you'll see detailed front-end feedback.
59
44
60
- ### 5 . API Usage via Curl/CLI Example:
45
+ ### 6 . API Usage via Curl/CLI Example:
61
46
``` bash
62
47
curl -u admin:change_this -X POST http://localhost:8000/api/test-latency \
63
48
-F dbtype=postgresql -F host=localhost -F port=5432 -F username=postgres -F password=yourpassword -F database=postgres -F interval=1 -F period=10
@@ -70,35 +55,30 @@ curl -u admin:change_this -X POST http://localhost:8000/api/test-latency \
70
55
71
56
The original ` delta.py ` script remains available for CLI power users and can test Oracle, PostgreSQL, MySQL, and URLs. ** No credentials are stored in this file** ; you must supply all values as arguments or interactively via a prompt.
72
57
73
- Use it like this (replace ALL UPPERCASE placeholders):
74
-
75
- ### Oracle Example
76
58
77
- ``` bash
78
- python delta.py --db oracle --user ADMIN_USER --password YOUR_PASSWORD --host " YOUR_ORACLE_DSN" --interval 3 --period 5 --csvoutput oracle_latency.csv
79
- ```
80
- - If you omit an argument, you will be prompted at runtime (passwords asked securely).
81
-
82
- ### PostgreSQL Example
83
-
84
- ``` bash
85
- python delta.py --db postgresql --user PG_USER --password YOUR_PASSWORD --host PG_HOST --port 5432 --database DB_NAME --interval 3 --period 5 --csvoutput postgres_latency.csv
86
- ```
87
- ### MySQL Example
59
+ ## Databases Supported 🔌 :
88
60
89
- ``` bash
90
- python delta.py --db mysql --user MYSQL_USER --password YOUR_PASSWORD --host MYSQL_HOST --port 3306 --database DB_NAME --interval 3 --period 5 --csvoutput mysql_latency.csv
91
- ```
92
- ### URL Example
61
+ ### Oracle DB >= 12.2 📌 :
62
+ - Amazon RDS Oracle
63
+ - OCI Autonomous Database
64
+ - OCI VMDB
65
+ - OCI Exadata Cloud Service
66
+ - Oracle Database On-Premise
93
67
94
- ``` bash
95
- python delta.py --db url --url " https://example.com" --interval 3 --period 5 --csvoutput url_latency.csv
96
- ```
97
- - All arguments can also be supplied interactively if omitted.
98
- - No passwords, usernames, or hostnames are stored in the codebase.
68
+ ### Postgres >= 11 📌 :
69
+ - Amazon RDS Postgres
70
+ - Amazon RDS Aurora Postgres
71
+ - Postgres On-premise
99
72
100
- ---
73
+ ### MySQL >= 5.7 📌 :
74
+ - Amazon RDS MySQL
75
+ - Amazon RDS Aurora MySQL
76
+ - OCI MySQL Database Service
77
+ - OCI MySQL Heatwave
78
+ - MySQL On-Premise
101
79
80
+ ### URL - HTTPS | HTTP 📌 :
81
+ - Check Public or Private URLs for latency
102
82
103
83
## Contributing
104
84
0 commit comments