python3使用libpcap给ESL命令添加日志记录

佛缘一生

操作系统 ：CentOS 7.6_x64FreeSWITCH版本 ：1.10.9python版本：3.9.12libpcap版本：1.11.0b7 FreeSWITCH的ESL模块用起来很方便，可以控制FreeSWITCH实现具体业务需求，但该模块没有提供ESL命令执行日志，不便于排查问题，本文展示一种使用python3基于libpcap实现ESL命令执行日志的方法，并提供示例代码及相关资源下载途径。一、背景描述

日常开发过程中观察到：通过ESL发送给FreeSWITCH的命令，在freeswitch.log中找不到记录。
查看代码发现，确实没有相关记录（mod_event_socket.c文件）：
static void *SWITCH_THREAD_FUNC api_exec(switch_thread_t *thread, void *obj)

分析后发现，大概有以下几个方法：

• 1、通过修改FreeSWITCH源代码实现
  

文件： mod_event_socket.c入口： api_exec
可通过switch_log_printf函数来实现。

• 2、使用tcpdump抓取
  

因EventSocket模块使用的是基于TCP的文本协议，且未加密，默认端口8021，可以通过tcpdump抓取event socket服务端口获取命令记录。

 示例如下：

1. tcpdump tcp dst port 8021 -w test1.pcap

复制代码

• 3、使用python3基于libpcap实现
  

底层原理和tcpdump一样，只是基于libpcap使用python3进行实现，会灵活很多，这也是本文终点描述的方法，具体实现在后续展开。二、具体实现

本文基于python3.9.12实现，CentOS 7环境编译及使用python3.9.12，可参考这篇文章：
https://www.cnblogs.com/MikeZhang/p/centos7-install-py39-20220704.html
关键点如下：
1、实时抓取网卡数据
可基于libpcap实时抓取网卡数据，具体可参考我之前写的文章：
https://www.cnblogs.com/MikeZhang/p/pythonUseLibpcap20221029.html
2、解析IP头获取源地址
需要获取发送ESL命令机器的源地址以便排查问题，IP数据包里面包含有源地址，python中解析IP头的示例如下：

1. ipInfo = struct.unpack('!BBHHHBBH4s4s',bytes(p[14:34]))
2. srcIp = socket.inet_ntoa(ipInfo[-2])
3. dstIp = socket.inet_ntoa(ipInfo[-1])

复制代码

3、解析TCP头获取具体数据
具体的ESL命令在TCP的数据部分保存，可通过解析TCP头获取ESL数据的起始下标，进而获取数据，示例如下：

1. tcpInfo = struct.unpack('!HHLLBBH',bytes(p[34:50]))
2. tcpHdrLen = (tcpInfo[4] >> 4) * 4
3. offset = 34 + tcpHdrLen
4. data = bytes(p[offset:tlen])

复制代码

4、使用logging模块进行记录
可使用python自带的日志模块记录ESL命令记录，并进行存盘，便于后续查看。
示例如下：

1. logger.info("(%s,%s)" % (srcIp,data))

复制代码

logger可在main函数中实现，指定具体的存盘文件，如果只是想控制台查看，则可以这样实现：

1. logger = logging.getLogger()
3. ...
5. logging.basicConfig(
6.     level=logging.DEBUG, # DEBUG,INFO,WARNING,ERROR,CRITICAL
7.     format='%(asctime)s %(filename)s[line:%(lineno)d] %(levelname)s %(message)s',
8.     datefmt='%a, %d %b %Y %H:%M:%S'
9. )

复制代码

基于上述关键点，可以实现ESL命令的日志记录，示例如下（eslLogTest1.py）：

完整代码可从如下渠道获取：
关注微信公众号（聊聊博文，文末可扫码）后回复 20231125 获取。三、运行效果

可使用ESL发送命令，然后用python脚本进行记录。发送ESL命令可使用ESL库，python3.9.12版本的ESL编译及使用，可参考这篇文章：
https://www.cnblogs.com/MikeZhang/p/py39esl-20230424.html
也可直接使用socket，示例如下（sendcmd1.py）：

1. import socket,time
3. def doCmd(sock,cmd):
4.     print(cmd)
5.     sock.send(cmd + b'\r\n\r\n')
7. sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)  
8. sock.connect(('192.168.137.32', 8021))  
9. sock.send(b'auth ClueCon\r\n\r\n')
10. doCmd(sock,b'bgapi originate user/1000 &echo')
11. time.sleep(10)
12. doCmd(sock,b'bgapi hupall')

复制代码

发送命令后，使用python实时记录的运行效果如下：

运行效果视频可从如下渠道获取：
关注微信公众号（聊聊博文，文末可扫码）后回复 2023112501 获取。四、资源获取

本文涉及资源，可以从如下途径获取：

 关注微信公众号（聊聊博文，文末可扫码）后回复 20231125 获取。
好，就这么多了，希望对你有帮助。

来源:https://www.cnblogs.com/MikeZhang/p/pyESLCapLog20211125.html
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！