doua-omrani commited on
Commit
12b9a54
·
1 Parent(s): 4e6121f

add knowledge base for Agent 1 RAG

Browse files
knowledge_base/telecom_causes_solutions.txt ADDED
@@ -0,0 +1,237 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # TELECOM NETWORK DIAGNOSTIC KNOWLEDGE BASE
2
+ # QoS Buddy - Causes & Solutions Reference
3
+
4
+ ## PROBLEM 1: CALL DROP (COUPURE D'APPEL) / CALL FAIL (ÉCHEC D'APPEL)
5
+
6
+ ### CAUSES POSSIBLES:
7
+ - Mauvais niveau signal (RSRP mauvais) - typically RSRP < -110 dBm
8
+ - Mauvais SINR / Interférences élevées - SINR < 5 dB indicates severe interference
9
+ - Mauvais handover (handover failed, taux de succès faible) - HO success rate < 85%
10
+ - Overshooting cell - cell coverage extends too far causing interference
11
+ - Mauvais voisinage (missing neighbors) - incomplete neighbor list affects handover success
12
+ - Mauvais tilt / azimut - incorrect antenna orientation
13
+ - Problème VoLTE (SRVCC failure) - Voice over LTE handover issues
14
+
15
+ ### SOLUTIONS:
16
+ - Optimisation tilt mécanique/électrique - adjust antenna tilt angle
17
+ - Ajustement puissance cellule - fine-tune cell transmission power
18
+ - Optimisation liste voisins - update and complete neighbor cell list
19
+ - Optimisation HO (Handover) - adjust handover parameters and thresholds
20
+ - Analyse zone trou de couverture → ajout site / small cell - identify coverage gaps and deploy additional infrastructure
21
+
22
+ ### KEY INDICATORS:
23
+ - RSRP < -110 dBm = Critical signal weakness
24
+ - Handover success rate < 85% = Handover optimization needed
25
+ - SINR < 5 dB = Severe interference problem
26
+
27
+
28
+ ## PROBLEM 2: MAUVAISE QUALITÉ VOIX (MOS FAIBLE)
29
+
30
+ ### CAUSES:
31
+ - Interférences UL/DL (RSRP) - uplink/downlink interference degrading voice quality
32
+ - BLER élevé - Block Error Rate > 5% indicates transmission errors
33
+ - Mauvais codec - inappropriate or inefficient voice codec selection
34
+ - Congestion PRB - Physical Resource Block congestion > 80%
35
+ - Mauvaise couverture indoor (RSRP) - poor indoor signal penetration
36
+
37
+ ### SOLUTIONS:
38
+ - Activer AMR adaptatif - enable adaptive multi-rate codec
39
+ - Optimiser puissance UL - optimize uplink power control
40
+ - Ajuster scheduler priorité VoLTE - prioritize VoLTE traffic in scheduler
41
+ - Ajouter couche 800/900 MHz pour indoor - deploy low-frequency layer for better indoor penetration
42
+ - Déploiement IBS / small cells - install indoor building systems or small cells
43
+
44
+ ### KEY INDICATORS:
45
+ - MOS < 3.0 = Poor voice quality
46
+ - BLER > 5% = High transmission errors
47
+ - PRB > 80% = Resource congestion affecting voice
48
+
49
+
50
+ ## PROBLEM 3: DÉBIT FAIBLE (LOW THROUGHPUT)
51
+
52
+ ### CAUSES:
53
+ - SINR faible - poor signal quality (SINR < 10 dB)
54
+ - PRB congestion - resource block utilization > 70%
55
+ - Mauvais CQI - Channel Quality Indicator < 8 indicates poor channel conditions
56
+ - Mauvais MIMO rank - suboptimal MIMO layer utilization
57
+ - Mauvaise bande passante (fréquence non adéquate) - insufficient bandwidth allocation
58
+
59
+ ### SOLUTIONS:
60
+ - Optimisation tilt - adjust antenna tilt for better signal distribution
61
+ - Ajout carrier (CA activation) - activate Carrier Aggregation for more bandwidth
62
+ - Activation 4x4 MIMO - enable advanced MIMO configuration
63
+ - Optimisation paramètres CQI - tune Channel Quality Indicator reporting
64
+ - Augmenter bandwidth (10 → 20 MHz) - increase channel bandwidth
65
+
66
+ ### KEY INDICATORS:
67
+ - Throughput DL < 25 Mbps = Low download speed
68
+ - SINR < 10 dB = Poor signal quality
69
+ - PRB > 70% = Resource congestion
70
+ - CQI < 8 = Poor channel conditions
71
+
72
+
73
+ ## PROBLEM 4: LATENCE ÉLEVÉE (HIGH LATENCY)
74
+
75
+ ### CAUSES:
76
+ - Congestion transport (temps de délai élevé) - transport network congestion
77
+ - Mauvais routage IP - suboptimal IP routing paths
78
+ - Bufferbloat - excessive buffering in network nodes
79
+ - Problème UPF / SGW - User Plane Function or Serving Gateway issues
80
+ - RLC retransmissions - Radio Link Control layer retransmissions > 10%
81
+
82
+ ### SOLUTIONS:
83
+ - Optimisation buffer - tune buffer sizes to reduce bloat
84
+ - Upgrade transmission - increase backhaul capacity
85
+ - Vérification MTU - verify Maximum Transmission Unit settings
86
+ - Optimisation scheduling - improve packet scheduling algorithms
87
+ - Local breakout - implement local internet breakout to reduce latency
88
+
89
+ ### KEY INDICATORS:
90
+ - Latency > 80 ms = High latency problem
91
+ - RLC retransmissions > 10% = Excessive retransmissions
92
+ - Normal latency target: 10-30 ms
93
+
94
+
95
+ ## PROBLEM 5: SESSION DATA DROP
96
+
97
+ ### CAUSES:
98
+ - ERAB drop - E-RAB (E-UTRAN Radio Access Bearer) drops
99
+ - Mauvais HO inter-frequency (HO, taux de succès handover) - poor inter-frequency handover performance
100
+ - Coverage hole (RSRP) - coverage gaps with RSRP < -115 dBm
101
+
102
+ ### SOLUTIONS:
103
+ - Optimisation HO thresholds (accélérer HO, ajuster timer) - adjust handover trigger thresholds and timers
104
+ - Ajuster timer T310 - tune T310 timer for radio link failure detection
105
+ - Ajouter cellule 800 MHz - deploy 800 MHz coverage layer
106
+ - Analyse drive test log (L3 events) - analyze Layer 3 signaling events from drive tests
107
+
108
+ ### KEY INDICATORS:
109
+ - RSRP < -115 dBm = Coverage hole
110
+ - Inter-frequency HO success < 90% = Handover optimization needed
111
+ - ERAB drop rate > 2% = Bearer stability issue
112
+
113
+
114
+ ## PROBLEM 6: HANDOVER FAILURE
115
+
116
+ ### CAUSES:
117
+ - Mauvaise définition voisins (dump, les relations de voisinage) - incorrect or incomplete neighbor definitions
118
+ - Overshooting cell (cellule à large couverture) - cell coverage extends beyond optimal range
119
+ - PCI confusion (identité de cellule confusion) - Physical Cell ID conflicts or confusion
120
+
121
+ ### SOLUTIONS:
122
+ - Nettoyage PCI - clean up Physical Cell ID plan to avoid conflicts
123
+ - Optimisation A3 offset - optimize A3 event offset parameters
124
+ - Ajuster TTT (time to trigger) - tune Time-To-Trigger for handover events
125
+
126
+ ### KEY INDICATORS:
127
+ - HO success rate < 85% = Handover failure problem
128
+ - PCI collisions detected = Need PCI planning
129
+ - Overshooting indicators = Coverage optimization needed
130
+
131
+
132
+ ## PROBLEM 7: PROBLÈMES DE CAPACITÉ (CAPACITY ISSUES)
133
+
134
+ ### SYMPTÔMES:
135
+ - PRB > 85% - Physical Resource Block utilization exceeds threshold
136
+ - CSSR baisse en heure chargée - Call Setup Success Rate drops during busy hour
137
+ - Débit chute en busy hour - throughput degradation during peak traffic (17:00-21:00)
138
+
139
+ ### SOLUTIONS:
140
+ - Ajout carrier - add additional carrier frequency
141
+ - Activation CA (carrier agrégation) - enable Carrier Aggregation
142
+ - Sectorisation 3 → 6 secteurs - increase sectorization from 3 to 6 sectors
143
+ - Massive MIMO (augmenter MIMO) - deploy advanced MIMO configurations
144
+ - Load balancing (réguler charge) - implement inter-cell load balancing
145
+
146
+ ### KEY INDICATORS:
147
+ - PRB > 85% = Capacity threshold exceeded
148
+ - Busy hour: 17:00-21:00 = Peak traffic period
149
+ - Throughput drops > 40% during busy hour = Capacity bottleneck
150
+
151
+
152
+ ## GENERAL THRESHOLDS & DECISION RULES
153
+
154
+ ### SIGNAL QUALITY:
155
+ - RSRP (Reference Signal Received Power):
156
+ * Excellent: > -80 dBm
157
+ * Good: -80 to -90 dBm
158
+ * Fair: -90 to -100 dBm
159
+ * Poor: -100 to -110 dBm
160
+ * Critical: < -110 dBm
161
+
162
+ - SINR (Signal-to-Interference-plus-Noise Ratio):
163
+ * Excellent: > 20 dB
164
+ * Good: 15-20 dB
165
+ * Fair: 10-15 dB
166
+ * Poor: 5-10 dB
167
+ * Critical: < 5 dB
168
+
169
+ ### RESOURCE UTILIZATION:
170
+ - PRB (Physical Resource Block) Utilization:
171
+ * Normal: < 70%
172
+ * Moderate: 70-85%
173
+ * High: 85-95%
174
+ * Critical: > 95%
175
+
176
+ ### VOICE QUALITY:
177
+ - MOS (Mean Opinion Score):
178
+ * Excellent: 4.0-5.0
179
+ * Good: 3.5-4.0
180
+ * Fair: 3.0-3.5
181
+ * Poor: 2.5-3.0
182
+ * Bad: < 2.5
183
+
184
+ ### HANDOVER PERFORMANCE:
185
+ - Handover Success Rate:
186
+ * Excellent: > 98%
187
+ * Good: 95-98%
188
+ * Fair: 90-95%
189
+ * Poor: 85-90%
190
+ * Critical: < 85%
191
+
192
+ ### THROUGHPUT:
193
+ - Downlink Throughput:
194
+ * Good: > 50 Mbps
195
+ * Fair: 25-50 Mbps
196
+ * Poor: 10-25 Mbps
197
+ * Critical: < 10 Mbps
198
+
199
+ ### LATENCY:
200
+ - Network Latency:
201
+ * Excellent: < 20 ms
202
+ * Good: 20-40 ms
203
+ * Fair: 40-80 ms
204
+ * Poor: 80-150 ms
205
+ * Critical: > 150 ms
206
+
207
+ ### ERROR RATES:
208
+ - BLER (Block Error Rate):
209
+ * Normal: < 2%
210
+ * Moderate: 2-5%
211
+ * High: 5-10%
212
+ * Critical: > 10%
213
+
214
+
215
+ ## DIAGNOSTIC WORKFLOW
216
+
217
+ ### Step 1: Identify Primary Symptom
218
+ - What is the user complaint? (call drops, slow data, poor voice quality, etc.)
219
+
220
+ ### Step 2: Gather KPI Evidence
221
+ - Check RSRP, SINR, PRB, throughput, latency, BLER, MOS
222
+ - Identify which KPIs are outside normal ranges
223
+
224
+ ### Step 3: Map to Problem Category
225
+ - Use the 7 problem categories above
226
+ - Consider time-of-day patterns (busy hour?)
227
+ - Check for multiple concurrent issues
228
+
229
+ ### Step 4: Recommend Solutions
230
+ - Prioritize quick wins (parameter optimization) before infrastructure changes
231
+ - Consider cost-benefit (software optimization vs. hardware deployment)
232
+ - Sequence solutions: optimization → tuning → capacity addition
233
+
234
+ ### Step 5: Validate & Monitor
235
+ - After implementing solution, monitor KPIs for 24-48 hours
236
+ - Verify improvement in target metrics
237
+ - Document lessons learned