Cloudinsight Agent 在 4.7.0 版本,将 Agent 名称从 oneapm-ci-agent 更换至 cloudinsight-agent。若您在使用过程中,出现无法正常工作的情况,请加入售后群:433349863
X

应用启动失败原因排查

探针启动失败有2种情况,一是探针没有安装成功,二是探针安装成功但没有启动成功。探针有没有安装成功,你可以看是否有可以执行 /etc/init.d/cloudinsight-agent info,如果不能执行,那就是没有安装成功;如果可以执行就看看输出有什么报错,再进行下一步分析。

下面将对各种可能造成的原因给出相应解决方法。


探针没有安装成功

探针在安装的时候会产生安装的 log,所以要看报错确定问题。


curl 问题

curl: (35) error:0D0C50A1:asn1 encoding routines:ASN1_item_verify:unknown message digest algorithm

这个问题多由证书本地 openssl 不能识别 SSL 证书签名算法所致。Cloudinsight 使用了 SHA-256 RSA 加密算法。而 openssl 在 OpenSSL 0.9.8o才加入此算法。

解决办法 是升级本地 openssl。


镜像无效

Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
http://yum.oneapm.com/x86_64/repodata/ae9772f136d882fd8f61b9c71e29c2630db3d5b211ef4ddc2b976af3006ebe1a-primary.sqlite.bz2: [Errno -3] Error performing checksum
Trying other mirror.
http://yum.oneapm.com/x86_64/repodata/ae9772f136d882fd8f61b9c71e29c2630db3d5b211ef4ddc2b976af3006ebe1a-primary.sqlite.bz2: [Errno -3] Error performing checksum
Trying other mirror.
Error: failure: repodata/ae9772f136d882fd8f61b9c71e29c2630db3d5b211ef4ddc2b976af3006ebe1a-primary.sqlite.bz2 from cloudinsight-agent: [Errno 256] No more mirrors to try.


这是 Centos 5 版本可能产生的问题,以上出错原因是发布 Cloudinsight 探针包时默认的 checksum(检验码)是 sha256 ,而 CentOS 5/rhel 5 版本不符合这个,所以安装不了这个安装包。

解决方法 :首先删掉因安装 Ci 添加的 yum 源rm -rf /etc/yum.repos.d/cloudinsight-agent.repo, 然后安装一个 hash 加密的模块:yum install python-hashlib,然后重新安装探针,参考解决 CentOS 5 安装 Cloudinsight 报错问题


用户密码权限问题

useradd: cannot  open  /etc/passwd

这是 Centos 7 版本可能产生的问题,具体参考解决 CentOS 7 安装 Cloudinsight 报错问题


unmet dependencies

* Installing APT package sources for Cloudinsight

Executing: gpg --ignore-time-conflict --no-options --no-default-keyring --secret-keyring /tmp/tmp.0dkKOJrsNY --trustdb-name /etc/apt/trustdb.gpg --keyring /etc/apt/trusted.gpg --primary-keyring /etc/apt/trusted.gpg --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 54B043BC
gpg: requesting key 54B043BC from hkp server keyserver.ubuntu.com
gpg: key 54B043BC: "Cloudinsight Packages <package@oneapm.com>" not changed
gpg: Total number processed: 1
gpg:              unchanged: 1

* Installing the Cloudinsight Agent package

Ign http://apt.oneapm.com stable InRelease
Hit http://apt.oneapm.com stable Release.gpg
Hit http://apt.oneapm.com stable Release
Hit http://apt.oneapm.com stable/main amd64 Packages
Hit http://apt.oneapm.com stable/main i386 Packages
Ign http://apt.oneapm.com stable/main TranslationIndex
Ign http://apt.oneapm.com stable/main Translation-en_US
Ign http://apt.oneapm.com stable/main Translation-en
Reading package lists...
Reading package lists...
Building dependency tree...
Reading state information...
You might want to run 'apt-get -f install' to correct these:
The following packages have unmet dependencies:
 kunagi : Depends: tomcat6 but it is not going to be installed
          Recommends: msttcorefonts
          Recommends: ttf-dejavu but it is not going to be installed
E: Unmet dependencies. Try 'apt-get -f install' with no packages (or specify a solution).
ERROR

以上报错说明 Ubuntu 系统内 APT 包源本身冲突,如果不安装更新软件的话这个问题不会表现出来,但在安装 Cloudinsight 探针时第一步执行的 sudo apt-get update,此时系统内如果有服务需要升级版本,就会报出错。如果没办法处理冲突问题,那就只能分布安装。具体安装方法见本文尾处。


探针安装成功没有启动成功

当一键安装后应用显示 down,没有数据,此时你需要先看看 log 来确定问题,有的已经会直接提示运行哪些命令,执行如下 info 命令。

/etc/init.d/cloudinsight-agent info

hostname 报错

2016-01-19 13:33:09,326 | CRITICAL | ci.collector | util(util.py:226) | Unable t                                                                   nt.conf or in your hosts file
Traceback (most recent call last):
  File "/opt/cloudinsight-agent/agent/agent.py", line 335, in <module>
    sys.exit(main())
  File "/opt/cloudinsight-agent/agent/agent.py", line 215, in main
    hostname = get_hostname(agentConfig)
  File "/opt/cloudinsight-agent/agent/util.py", line 227, in get_hostname
    raise Exception('Unable to reliably determine host name. You can define one
Exception: Unable to reliably determine host name. You can define one in oneapm-

安装 Ci 探针后,默认会以服务器系统的 hostname 作为应用名称,默认的 localhost、 localhost.localdomain、 localhost6.localdomains 等名称是无效的,所以需要修改 hostname,保证其唯一性。

解决方法 修改 /etc/cloudinsight-agent/cloudinsight-agent.conf hostname: xxxx 指标(a-zA-Z1-9,且不能有下划线),此处的 hostname 只是作为应用的名称而存在,与服务器本身的 hostnme 没有关系,所以可以任意设置。


时间问题

Clocks
======

  NTP offset: 229140.0818 s
  System UTC time: 2016-04-22 10:23:32.445928

像上面这种时你需要查看你的服务器时间是否是北京时间,因为探针采集数据是按照时间序列采集的,发送到我们云端,此时存储方式也是安装时间序列,发送到前端展示的时候依旧会按照采集到时间序列,但默认前段展示的是北京时间最近30分钟的数据,所以会显示没有数据。

解决方法 服务器时间同步为北京时间


Error setting up syslog

[root@S-C7 conf.d]# /etc/init.d/cloudinsight-agent restart
Stopping Cloudinsight Agent (using killproc on supervisord): [ OK ] Error setting up syslog: '[Errno 13] Permission denied' Traceback (most recent call last): File "/opt/cloudinsight-agent/agent/config.py", line 1004, in initialize_logging handler = SysLogHandler(address=sys_log_addr, facility=SysLogHandler.LOG_DAEMON) File "/opt/cloudinsight-agent/embedded/lib/python2.7/logging/handlers.py", line 761, in __init__ self._connect_unixsocket(address) File "/opt/cloudinsight-agent/embedded/lib/python2.7/logging/handlers.py", line 789, in _connect_unixsocket self.socket.connect(address) File "/opt/cloudinsight-agent/embedded/lib/python2.7/socket.py", line 228, in meth return getattr(self._sock,name)(*args) error: [Errno 13] Permission denied

解决方法 此为 syslog 文件找不到,修改 /etc/cloudinsight-agent/cloudinsight-agent.conf 里面 logtosyslog 设置为 no ,重启探针即可。

Info 命令如果看着没问题,看看探针的 log,在 /var/log/cloudinsight-agent 下面有 collector.log,forwarder.log,jmxfetch.log,statsd.log 和 supervisor.log 几个文件。其中 collector.log 记录探针收集状况的 log ,forwarder.log 记录探针发送到 Cloudinsight SaaS 的传输情况。


端口被占用

2016-04-26 10:49:03 CST | ERROR | ci.forwarder | forwarder(forwarder.py:479) | Socket error [Errno 98] Address already in use. Is another application listening on the same port ? Exiting
Traceback (most recent call last):
  File "/opt/cloudinsight-agent/agent/forwarder.py", line 467, in run
    http_server.listen(self._port, address=self._agentConfig['bind_host'])
  File "/opt/cloudinsight-agent/embeddedb/python2.7/site-packages/tornado/tcpserver.py", line 117, in listen
    sockets = bind_sockets(port, address=address)
  File "/opt/cloudinsight-agent/embeddedb/python2.7/site-packages/tornado/netutil.py", line 104, in bind_sockets
    sock.bind(sockaddr)
  File "/opt/cloudinsight-agent/embeddedb/python2.7/socket.py", line 228, in meth
    return getattr(self._sock,name)(*args)
error: [Errno 98] Address already in use

Ci 探针默认通过 10010 端口传输数据至 Cloudinsight 服务器,如果此端口被其他程序占用,连接就会失败,报出以上错误。

解决方法 您可以检查占用该端口的应用程序,如果方便,可以 kill 此进程或修改此进程的端口;如果不方便修改,则可以修改 /etc/cloudinsight-agent/cloudinsight-agent.conf 路径下的配置文件,修改此端口。

listen_port: 17121(任意未使用端口)

修改之后重新启动探针即可。


Unable to post payload

2015-12-25 11:40:54 CST | ERROR | ci.collector | checks.collector(emitter.py:69) | Unable to post payload.
Traceback (most recent call last):
  File "/opt/cloudinsight-agent/agent/emitter.py", line 61, in http_emitter
    r = requests.post(url, data=zipped, timeout=5, headers=headers)
  File "/opt/cloudinsight-agent/embedded/lib/python2.7/site-packages/requests/api.py", line 108, in post
    return request('post', url, data=data, json=json, **kwargs)
  File "/opt/cloudinsight-agent/embedded/lib/python2.7/site-packages/requests/api.py", line 50, in request
    response = session.request(method=method, url=url, **kwargs)
  File "/opt/cloudinsight-agent/embedded/lib/python2.7/site-packages/requests/sessions.py", line 464, in request
    resp = self.send(prep, **send_kwargs)
  File "/opt/cloudinsight-agent/embedded/lib/python2.7/site-packages/requests/sessions.py", line 576, in send
    r = adapter.send(request, **kwargs)
  File "/opt/cloudinsight-agent/embedded/lib/python2.7/site-packages/requests/adapters.py", line 415, in send
    raise ConnectionError(err, request=request)
ConnectionError: ('Connection aborted.', error(97, 'Address family not supported by protocol'))

如果有以上 Unable to post payload 的问题,但不是连接超时问题,这是因为探针默认会读取 localhost 的数据,如果本机没有把 localhost 解析成 127.0.0.1 ,就会报这个错误,所以可以对本机进行解析,也可以在 Cloudinsight 配置文件里面绑定 127.0.0.1。可以修改 /etc/cloudinsight-agent/cloudinsight-agent.conf 文件,在里面添加如下内容:

bind_host: 127.0.0.1

之后重启探针,在 web 上看看是否已经有数据。

如果有以上 Unable to post payload 的问题,但是连接超时问题,可以忽略,偶尔1~2次数据没有传输上去,不会有影响,Cloudinsight Agent 有30M 缓存,数据没有发送成功下次发送时回一并发过去,直至发送成功。


license_key

如果 collector.log 和 forwarder.log 都没有报错,你应该考虑是不是 licensekey 写错了,我们正确的 licensekey 末尾都是有等号的,例如 B1oCTldEV6b2bAoVCEwID0918f35hQdXH1I9f9dBHApWFVQIcb79VVZfti4bUAU= ,所以查看自己的 license_key ,修改正确,重启探针就行啦。正确格式如下:

me  18:49:46
# The host of the Cloudinsight data collector server to send Agent data to
ci_url: https://dc-cloud.oneapm.com

# The Cloudinsight license key to associate your Agent's data with your organization.
license_key: B1oCTldEV6b2bAoVCEwID0918f4FCQdXH1I9f9dBHApWFVQIcb79VVZPBw4bUAU=

探针发送数据频率

探针30s 采集一次数据,15s 秒发送一次数据,这是为了保证数据全部发送过去。

探针对于状态值检验(执行 info 命令所输出的系统以及各个监控组件的是非正常发送数据的检验,正常是绿色,黄色是警告,不影响数据,红色是发生错误 )是10分钟发送一次,所以如果界面上的状态和执行 info 后输出的有所不一致,那再等几分钟,为了避免资源损耗,这个发送频率是10分钟。

同样界面上如果连续10分钟没有收到数据,应用状态就会显示为 down,3天没数据,这个应用就会自动删除。


分步安装

如果操作系统本身 YUM/APT 源有问题,可以进行分步安装:

sudo apt-get autoremove
sudo apt-get autoclean
wget http://apt.oneapm.com/pool/main/cloudinsight-agent_x.x.0-1_amd64.deb  (可以自行查看当前版本)
dpkg -i cloudinsight-agent_x.x.0-1_amd64.deb
cd /etc/cloudinsight-agent/
cp cloudinsight-agent.conf.example   cloudinsight-agent.conf  
vi cloudinsight-agent.conf( 修改成自己的 license_key )
/etc/init.d/cloudinsight-agent restart
sudo yum update
wget http://yum.oneapm.com/x86_64/cloudinsight-agent-x.x.0-1.x86_64.rpm
rpm -Uvh cloudinsight-agent-x.x.0-1.x86_64.rpm
cd /etc/cloudinsight-agent/
cp cloudinsight-agent.conf.example   cloudinsight-agent.conf  
vi cloudinsight-agent.conf( 修改成自己的 license_key )
/etc/init.d/cloudinsight-agent restart

如果您对 Cloudinsight 感兴趣,可以选择试用我们的产品,只需要点击下面的按钮免费注册即可。


立即注册 Cloudinsight