Spring-cloud

2025-09-22 03:57:50

服务查询

您可以通过MSAP查询部署的Spring Cloud应用的服务列表和服务详情。 

查看服务列表 

在左侧导航栏,选择微服务治理 > Spring Cloud > 服务查询。查看当前账号下的Spring Cloud服务。Spring Cloud服务支持查看服务名、应用名和实例数。如果服务较多,可以通过环境、服务名、应用名进行筛选或搜索,服务名和应用名大小写不敏感。 

查看服务详情 

在服务查询页面,单击服务名称查看服务的详细信息。服务详情面板包含基本信息、服务调用关系和元数据。 

  • 基本信息

  • 服务调用关系

  • 元数据


标签路由

标签路由通过标签将一个或多个服务的提供者划分到同一个分组,从而约束流量只在指定分组中流转,实现流量隔离的目的。标签路由可以作为多版本开发测试、同应用的多版本流量隔离以及A/B Testing等场景的能力基础。 

查看标签路由列表 

在左侧导航栏,选择微服务治理 > Spring Cloud > 标签路由。查看当前账号下的标签路由。标签路由展示了发布应用的标签记录,如果服务较多,可以通过环境、应用名进行筛选或搜索,应用名大小写不敏感。 

添加流量规则 

在标签路由页面选择一个标签路由,然后单击添加流量规则。 

  • 路由名称:标签路由规则名称,例如lable-A。

  • 是否链路传递:如果需要使用全链路流控,请打开是否链路传递开关。

  • 框架类型:被调用的应用所使用的框架,选择Spring Cloud。

  • Path:HTTP的相对路径。

  • 条件模式:包含同时满足下列条件和满足下列任一条件,根据实际需求选择。

  • 条件列表:可以分别设置Parameter、Cookie、Header和Body Content四种类型的参数。例如:Parameter:name=ctyun Cookie:userId = 1 或 2


服务鉴权

当您的某个微服务应用有安全要求,不希望其它所有应用都能调用时,可以对调用该应用的其它应用进行鉴权,仅允许匹配鉴权规则的应用调用。 

查看服务鉴权规则列表 

在左侧导航栏,选择微服务治理 > Spring Cloud > 服务鉴权。查看当前账号下的服务鉴权规则。服务鉴权规则展示了规则名称、状态、被调用方框架、被调用方类型、被调用方等信息,如果服务较多,可以通过环境、规则名称、被调用方进行筛选或搜索。 

创建服务鉴权规则 

在服务鉴权规则页面单击创建规则。 

  • 环境:选择一个环境。

  • 规则名称:服务鉴权规则名称,例如 auth-product。

  • 被调用方类型:这里只可以选择应用。

  • 被调用方:被调用的应用。

  • 被调用方框架:被调用的应用所使用的框架,选择Spring Cloud。

  • 接口规则:

    • 被调用方Path:指定被调用应用的Path

    • 鉴权方式:服务鉴权的方式,包含白名单(允许调用)和黑名单(拒绝调用),请根据实际鉴权需求选择。

    • 调用方(应用):需要鉴权的调用方应用,可以单击添加调用方设置多个需要鉴权的调用方应用。


服务降级

业务高峰期时。您可以通过服务降级功能,对部分的服务消费者进行降级操作,让不重要的业务方不进行真实地调用,直接返回降级的结果,将宝贵的下游服务提供者资源保留给重要的业务调用方使用,从而提升整体服务的稳定性。 

查看服务降级规则列表 

在左侧导航栏,选择微服务治理 > Spring Cloud > 服务降级。查看当前账号下的服务降级规则。服务降级规则展示了规则名称、服务提供者应用、服务降级应用、应用框架、状态等信息,如果服务较多,可以通过环境、规则名称、被调用方进行筛选或搜索。

创建服务降级规则 

在服务降级规则页面单击创建降级规则。 

  • 环境:选择一个环境。

  • 规则名称:服务降级规则名称,例如 order-sales。

  • 规则描述:服务降级规则描述。

  • 服务提供者应用:选择提供服务的应用。

  • 降级应用:选择被调用的降级服务应用。

  • 降级规则: o框架类型:选择Spring Cloud类型框架。

    • 服务路径:选择服务应用和Path。

    • 请求方法:选择应用的请求方式。

    • 执行策略:选择服务降级的执行策略,包括所有请求生效和请求异常生效,请根据实际需求进行选择。

    • 降级策略:选择服务降级的具体策略,包含返回Null值、返回Exception异常、返回自定义JSON数据和自定义回调,请根据实际需求选择。


离群实例摘除

在微服务架构中,当服务提供者的应用实例出现异常,而服务消费者无法感知时会影响服务的正常调用,并影响消费者的服务性能甚至可用性。离群实例摘除功能会检测应用实例的可用性并进行动态调整,以保证服务成功调用,从而提升业务的稳定性和服务质量。 

查看离群实例摘除策略列表 

在左侧导航栏,选择微服务治理 > Spring Cloud > 离群实例摘除。查看当前账号下的离群实例摘除策略。离群实例摘除策略展示了策略名称、状态、生效应用、针对框架、异常类型、错误下限率、QPS下限、摘除实例比例上限、恢复检测单位时间、未恢复累计次数上限等信息,如果服务较多,可以通过环境、规则名称、被调用方进行筛选或搜索。 

创建离群实例摘除策略 

在离群实例摘除页面单击创建离群实例摘除策略。 

  • 环境:选择一个环境。

  • 策略名称:离群实例摘除策略名称,例如 ctyun-remove。

  • 被调用服务所用框架: 未恢复累计次数上限。

  • 选择生效应用:选择生效应用后,该应用的调用的所有应用的异常实例会被摘除。摘除期间,生效应用的调用请求将不再被分发到异常实例。

  • 错误下限率:当被调用的应用中某个应用实例的错误率高于设置的下限后,将摘除该实例。默认值为50%。例如该实例在统计时间窗口内被调用10次,有6次调用失败,错误率为60%,超过了配置的错误率下限(50%),则从应用中移除该实例。

  • 高级配置:

    • 异常类型:选择网络异常+业务异常(HTTP 5xx)。

    • QPS 下限:QPS按照统计时间窗口进行计算,Spring Cloud应用的统计时间窗口为10秒。当在统计时间窗口(例如10秒)内应用的QPS达到设置的下限后开始进行错误率统计分析。

    • 摘除实例比例上限:摘除的异常实例比例上限,即达到阈值后,不再摘除异常实例。摘除异常实例数向下取整,例如应用实例总数为6,摘除实例比例设置为60%,摘除实例比例数为6 x 60% = 3.6,则按策略最多摘除的实例数为3。若计算结果小于1,则不会摘除实例。

    • 恢复检测单位时间:在异常实例被摘除后,按单位时间线性不断累加的时间作为检测间隔,检测异常实例是否恢复正常,单位为ms。默认为30000ms,即0.5分钟。

    • 未恢复累计次数上限:持续对异常实例进行检测,检测间隔随检测次数按恢复检测单位时间线性增加,当达到设置的检测次数上限后,会按最长时间间隔持续检测异常实例是否恢复。例如,恢复检测单位时间设置30000ms,未恢复累计次数上限设置为20,在第20次检测异常实例仍未恢复后,则会按10分钟(20 x 30000 ms)为间隔执行后续的检测。如果检测到实例已经恢复,则会将检测间隔重置为初始的时间间隔,即一次恢复检测单位时间。


服务测试  

在日常开发中,开发人员或测试人员需要临时调用线上服务来调试已经部署的服务或查询线上数据。服务测试功能可以让您在控制台填写调用参数、发起服务调用,并得到服务调用的结果。 

查看服务列表 

在左侧导航栏,选择微服务治理 > spring cloud > 服务测试。查看当前账号下可以进行测试的Spring Cloud服务。如果服务较多,可以通过环境、服务名、应用名进行筛选或搜索,服务名和应用名大小写不敏感。 

服务测试 

再服务测试列表操作列,单击测试,在测试服务面板中设置参数,然后单击执行,等待返回结果。 

  • 调用IP:服务的实例(ECS或Pod)IP。如果部署了多个实例,在列表中选择其中一个IP,进行测试,只能单选。

  • Path:请求服务的接口路径,在列表中选择其中一个路径,只能单选。

  • 请求方法:该所属类的请求方法,包含GET\PUT\POST\DELETE多个请求方法,在列表中选择其中一种方法,只能单选。


自动化测试-用例管理

自动化回归功能基于服务契约信息快速编排被测服务、管理自动化测试用例,帮助您高效管理、回归业务测试场景,完成业务快速验证和交付。 

查看用例列表 

在左侧导航栏,选择微服务治理 > spring cloud > 自动化测试-用例管理。查看当前账号下的用例列表。用例列表展示了用例名称、最后一次执行时间、最后一次结束时间、最后一次执行结果等信息,如果用例较多,可以通过环境、用例名称进行筛选或搜索。

 创建用例 

在用例列表页面,单击创建用例按钮。 

  • 用例名称:自定义测试用例名称。

  • 步骤名称:自定义测试步骤名称。

  • 环境:选择一个环境。

  • 应用:选择需要测试的应用。

  • 框架类型:选择Spring Cloud框架。

  • 服务:选择需要测试的服务。

  • Path:选择需要测试的服务接口路径。

  • 基本信息:设置请求方法和ContentType。请求方法包括GET/POST/PUT/DELETE,ContentType包括x-www-form-urlencoded和raw,不同的ContentType提供不同可视化的参数输入方式。x-www-form-urlencoded:表单输入,传递的参数格式为[{"name": "张三"},{"age": 20}]。raw:默认为application/json JSON格式输入,传递的参数格式为{"name": "张三", "age": 20}。

  • 请求头: 设置请求头参数信息。 断言(选填):输入检查对象和检查内容,选择检查条件。

  • 出参提取(选填):输入出参名和出参提取表达式。

用例详情 

在用例列表页面操作列,单击详情按钮,进入到用例详情页面。在用例详情页面可以看到用例的具体信息,单击立即执行按钮用例就会开始执行,单击访问一次按钮,对应的步骤则会执行一次。 

用例执行 

在用例列表页面操作列,单击执行按钮,用例就开始执行,功能与用例详情页立即执行按钮相同。 

用例复制 

在用例列表页面操作列,单击复制按钮,复制出一条一样的测试用例。 

用例删除 

在用例列表页面操作列,单击删除按钮,删除对应的测试用例。


自动化测试-用例集 

自动化回归测试用例集功能通过关联测试用例,帮助您快速完成业务验证和交付。 

查看用例集列表 

在左侧导航栏,选择微服务治理 > spring cloud > 离自动化测试-用例集。查看当前账号下的用例集列表。用例集列表展示了用例集名称、执行次数、最近执行时间、最近执行时长、最近执行结果等信息,如果用例集较多,可以通过环境、用例集名称进行筛选或搜索。 

创建用例集 

在用例列表页面,单击创建用例集按钮。选择环境输入用例集名称后单击确定。 

用例集详情 

在用例列表页面操作列,单击详情按钮进入用例集详情页面,用例集详情页面展示了展示了关联的用例列表、集合变量、执行历史等信息。在集合详情页面可以执行创建用例、关联用例、导入导出脚本等操作。 

执行用例集 

在用例列表页面操作列,单击执行按钮,用例集执行会执行用例集中关联的所有用例。 

删除用例集 

在用例列表页面操作列,单击删除按钮,删除对应的用例集。


服务Mock  

您可以通过MSAP创建Mock服务,系统自动根据请求参数返回不同的结果,并且随机生成返回数据,能够真实地模拟后端服务,支持系统联调。例如部署了2个应用:生产者Provider和消费者Consumer,Consumer依赖了Provider的接口,由于Provider的代码还没准备就绪,可以选择Consumer应用创建Mock规则,模拟Provider的接口返回值。 

服务Mock列表 

在左侧导航栏,选择微服务治理 > spring cloud > 服务Mock。查看当前账号下的服务Mock列表。服务Mock列表展示了规则名称、应用、状态等信息,如果服务Mock较多,可以通过环境、规则名称进行筛选或搜索。

创建服务Mock 

在服务Mock列表页面,单击创建服务Mock按钮,进行服务Mock规则创建。 

  • 环境:选择一个环境。

  • 规则名称:自定义规则名称。

  • 描述:规则描述。

  • 调用方:选择需要Mock应用。

  • Mock规则列表:

    • 框架类型:选择Spring Cloud框架。

    • 服务路径:选择需要Mock的服务接口路径。

    • 请求方法:包含GET\PUT\POST\DELETE多个请求方法,在列表中选择其中一种方法,只能单选。

    • 条件模式:选择服务Mock规则的条件策略,包括同时满足下列条件和满足下列任一条件,请根据实际需求进行选择

    • 条件列表:单击添加新的规则条件,设置规则条件。Spring Cloud应用支持Parameter\Header\Cookie\Body Content参数输入方式

    • Mock策略:默认支持返回自定义JSON数据策略。

    • 返回延迟:自定义请求的响应时间,单位:ms。


服务Mock编辑 

在服务Mock列表页面操作列,单击编辑按钮进入服务Mock编辑页面。在编辑页面可以编辑描述、规则列表信息,编辑完成后单击确认按钮进行保存。 

服务Mock关闭 

在服务Mock列表页面操作列,单击关闭按钮,关闭对应的Mock规则。 

服务Mock删除 

在服务Mock列表页面操作列,单击删除按钮,删除对应的Mock规则。


Mz_JO41YI3nR