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