使用最新的JFrog产品?hth华体会最新官方网站
JFrog平台用户指南
JFrog x射线x文档
要获取最新版本,请访问JFrog统一平台
总体状态是各种参数状态的累加。下表描述了监视的参数和生成通知的条件。请注意,根据情况的严重程度,有些通知可能被归类为“警告”或“错误”:
参数 | 通知条件 |
---|---|
连接到PostgreSQL数据库 |
没有关系 |
连接MongoDB数据库 |
没有关系 |
连接RabbitMQ消息服务 |
没有关系 |
连接到全局数据库服务器 |
没有关系 |
连接到人工实例 | 没有关系 |
连接到集成服务(例如Whitesource) | 没有关系 |
重启服务 | 警告过去5小时内有3起 错误在过去的5小时内,有50人死亡 |
平均CPU使用率 | 警告:90% 错误:95% |
平均RAM使用率 | 警告:90% 错误:95% |
系统打开文件使用率 | 警告:最大值的80% 错误:最大值的95% |
工作目录磁盘使用情况 | 警告:总额的80% 错误:占总量的95% |
x射线数据文件夹磁盘使用情况 | 警告:x射线配置文件中指定的最大值的80% 错误:x射线配置文件中指定的最大值的95% |
失败消息计数 | 警告:失败消息超过0条 错误:超过100条失败消息 |
系统日志
正在建设的功能-即将到来!
我们目前正在UI中为JFrog日志开发一种新的表示方式。JFrog日志仍然可以通过REST API访问。与Artifactory不同的是,x射线日志在Xray 3.0版本的UI中是不可用的,但很快就会添加进来。
你可以查看x射线的系统日志管理模块下系统日志。
Microservice过滤器 |
单击列出的任何微服务来启用或禁用该微服务的日志记录。对于每个微服务,您可以将日志级别设置为ERROR, WARN, INFO, DEBUG或FINE。 |
自动刷新 |
启用后,当添加新的日志条目时,显示将自动刷新自身。 |
自动滚动 |
启用后,当添加新的日志条目时,显示将自动滚动。 |
下载日志 |
单击可下载日志文件当前状态的硬拷贝。 |
清除日志 |
单击清除显示。这不会从实际日志文件中删除任何条目。 |
系统消息
x射线管理员可以在Admin模块下的System messages页面中查看所有工件和数据故障消息的列表。每个故障都可以追溯到过程中的确切步骤扫描和影响分析在x射线过程中失败,允许管理员修复问题并重试该步骤。或者联系JFrog支持部门进行进一步调查。
使用“按主题筛选”框并通过选择特定扫描和影响步骤搜索特定故障。
主题 |
x射线正在扫描的失败工件的名称,或者在影响分析的情况下的数据更新,例如漏洞和许可证名称。 |
源 |
x射线扫描工件的位置(包括实例名称、repo名称和repo中的路径),或者在影响分析的情况下数据更新的来源(包括数据库同步或分配的自定义问题)。 |
一步 |
工件失败的步骤(包括过程和步骤名称)。 |
时间戳 |
故障发生的时间。默认情况下,网格将按最新故障到最老故障排序。 |
错误 |
描述导致此失败的原因的详细错误消息。 |
扫描
每次将新的工件或构建添加到连接的Artifactory实例时,Xray都会扫描它及其依赖项,以查找已知的漏洞和遵从性违规,并相应地生成问题。这个过程被称为“扫描”。这包括以下流程步骤:
- 事件
- 指数
- 坚持
- 分析
- 警报
- 通知
- Artifactory更新
影响分析
每次新的组件元数据可用时(漏洞、许可证等),Xray都会在组件图中查找组件,如果更新匹配任何监视,Xray将生成一个问题并创建其影响的地图,以确定哪些工件最终受到它的影响。这个过程被称为“影响分析”。这包括以下流程步骤:
- 分析
- 警报
- 通知
- Artifactory更新
导出和导入配置设置
Y您可以使用一组专用的REST api导出x射线用户自定义配置,以便导入到其他x射线实例中。当跨多个环境(开发、测试、登台和生产)复制设置时,或者移动到单个x射线与人工实例的比率时,这主要是有用的。以下设置包括策略、监视、忽略规则、自定义许可证、自定义问题、webhook、邮件服务器、代理配置和索引资源设置。
REST API
Xray REST API提供了以下端点,您可以使用它们来导出和导入Xray配置设置。
导出x射线设置 |
将配置导出为zip文件,路径如下:< XRAY_HOME > /备份/ config / < SERVICE_ID > _xray_exported_config_ <时间> . zip。 |
导入x射线设置 |
从导出的zip文件中导入配置设置。 |
备份和恢复
JFrog x射线是由几个去“服务以及一些外部服务。每个都需要分开处理。
Xray的备份和恢复解决方案基于存储快照来存储数据和配置。为了确保数据的一致性和可靠性,所有的x射线服务必须在运行快照工具或保留事务日志之前将其数据刷新到磁盘。
备份目录
应该备份的目录取决于您是否在Docker容器中运行Xray。
Docker备份目录
要备份运行在Docker容器中的Xray,需要备份$XRAY_MOUNT_ROOT目录,该目录包含以下子目录:
x光
postgres
rabbitmq
- mongodb
例如,如果$XRAY_MOUNT_ROOT=/root/.在Jfrog /xray中,您需要备份以下目录:
- /root/.jfrog/xray/xray
- /root/.jfrog/xray/postgres
- /root/.jfrog/xray/rabbitmq
- /root/.jfrog/xray/mongodb
非docker备份目录
对于非docker发行版,Xray的数据分布在以下目录中:
x射线Go服务 |
/var/opt/jfrog/xray/data |
PostgreSQL |
/var/opt/jfrog/postgres/data |
RabbitMQ |
有关默认Linux目录的列表,请参考RabbitMQ文档.与Xray相关的目录有:
|
MongoDB |
Linux发行版默认的MongoDB数据目录(参见MongoDB文档):
|
运行备份
要运行备份,只需为每个文件创建一个快照备份目录在前一节中描述。
从备份恢复
在从快照恢复之前,我们建议备份当前状态。
从备份中恢复x射线:
- 停止x光
中的数据覆盖备份目录与相应的数据在您的备份
开始x光
获得支持
JFrog为专业和企业许可层提供基于SLA的支持。如果您已经购买了其中一个级别,您可以通过JFrog支持门户与JFrog支持联系。在大多数情况下,JFrog支持将需要一些关于系统和相关日志文件的初始信息。为了加快处理您的问题,Xray可以让您生成所有最初需要的信息管理模块支持区域屏幕上。在打开支持票据时,您可以附加信息包以加快问题的处理。
请求支持
要请求支持,请创建一个包信息有了相关资料,并登录到JFrog支持门户打开支持票并附上信息包。
我应该包括什么?
我们建议在上传的信息包中包含所有项目,除非您确定JFrog支持将需要哪些信息来解决您的问题。
收集信息包
支持区提供了各种选项,用于选择在提供JFrog支持的包中包含哪些信息。
系统信息 |
提供有关系统的信息,包括存储、系统属性、JVM信息和插件状态。 |
人工实例配置 |
提供有关Artifactory实例设置的信息。 |
配置文件 |
提供影响x射线功能的配置文件。 |
消息队列 |
提供有关Xray中消息队列的信息。 |
数据库同步信息 |
提供有关数据库同步状态的信息。 |
系统日志 |
如果选中,系统日志将包含在信息包中。您可以指定应该包含系统日志的时间范围。 日期范围 日期范围根据文件名中存在的时间戳来考虑文件,而不是根据其内容。 |
线程转储 |
Xray将为所有正在运行的线程创建一个线程转储。默认情况下会创建单个线程转储,但是,为了了解数据随时间变化的情况,您可以请求由指定时间间隔分隔的多个线程转储线程转储数和时间间隔字段。 |
选中希望包含在信息包中的所有信息项后,单击“Create”创建信息包。
x光哈
在为Xray HA安装创建信息包时,该信息包由碰巧处理“Create”请求的特定HA节点创建。
资源密集型作业
请注意,创建线程转储和系统日志可能是资源密集型操作,并可能创建大量信息包。
先前创建的包
控件中显示每个信息包先前创建的包列表。如果使用Artifactory 6.8及更高版本(包括对Information bundle存储库的支持)创建该包,则可以下载该包.