The FeatureProbe User Guide provides an overview of FeatureProbe, instructions on how to set up accounts and projects, and complete examples of adding, editing and using feature toggles.
New features launching or version release are the most common use of FeatureProbe. When we launch a new feature or update the service, we can enable them for a small fraction of the users in the first place to make sure things go smoothly without impacting the majority of users. If those users don't complain or even give good feedback, we can populate the changes to more users, and repeat the procedure till all users update to the new version.
Further more, there are many other scenarios where we can use FeatureProbe.
Many companies periodically carry out promotion activities to boost sales. These activities use similar templates in most cases, and the operation team just need to modify several parameters to create a new promotion.
Use Case: An online shopping platform carries out a Black Friday sales gala and needs to change prices for many items. In the past, the R&D team change items prices and launch the changes with a long workflow. Now they can use FeatureProbe to toggle the items price and make them effective within a second.
Operation Procedure
FPUser user = new FPUser(user_id);
user.with("city", city_name);
double discount = fpClient.numberValue("commodity_spike_activity", user, 1.0);
discountSetTo(discount);
When the online service encounters extremely high demands that impact some dependency services or there is something goes wrong (for example, a backend service gets inaccessible unexpectedly), we need to guarantee the essential services work without disruption by using the cached data rather than fetching data from those problem services.
Use Case: The ecommerce service needs to call an inventory stocking service to show the product stocking information. If the stocking service encounters some issue and is not available, the operation team can make use of FeatureProbe to get stocking data from the cached content within a second and carry out the time costly application fallback operation or switch over to a backup service without interrupt the online service.
Operation Procedure
FPUser user = new FPUser(user_id);
boolean fallback = fpClient.boolValue("store_service_fallback", user, false);
if (fallback) {
// Do something.
} else {
// Do normal process.
}
Design several solutions for a specific service, try them all and find out the most optimal/popular one.
Use Case 1: Decide a button's color. Mike, the product manager, wants to change a "Buy" button for their ecommerce platform in Paris. The original color is in red, and he believes the Paris people would like blue, and he also wants to try green. He uses FeatureProbe to do the A/B testing to find out the better choice.
Operation Procedure
FPUser user = new FPUser(user_id);
user.with("city", city_name);
String color = fpClient.stringValue("color_ab_test", user, "red");
setButtonColor(color);
One More Thing: We provide a small trick in the demo project that enables you to display different logos for different browsers. Try to find it out and make your website a little more interesting.
You can use a valid account and its password to log in the FeatureProbe portal.
If it is the first time you log in a FeatureProbe service, you can use the default administrator account as
Admin/Pass1234
. Remember to change the password after you log in for the first time.
Use an Administrator account to log in the FeatureProbe portal and create new accounts at the Account Settings
page with below steps:
+ Member
button in blue.Accounts
field. You can massively create accounts by filling multiple accounts and
separating them with commas.Default Password
and use your own password.Add
button in the upper right corner to finish account creation.Note: new accounts will get effective immediately after they are created.
The default "Admin" account cannot be edited by any account, and it can edit any other account.
You can edit an account's password and save it to make the edit effective.
Node: the account member will be automatically logged out if you edit its password and there is no activities of the logged in account.
The default "Admin" account cannot be deleted by any account, and it can delete any other account.
Click delete
button and Confirm
to delete it on the pop-up window.
Note: Once an account has been deleted, you cannot create another account by using the same name.
It is highly recommended changing an account's default password immediately after it is created with below steps:
One FeatureProbe account can manage multiple business objects by setting up Projects. For example, you can create a
project named "mobile client side app" and another project named "server side app", and set up its unique environments
and toggles respectively. The FeatureProbe system provides a default initial project named "My First Project" and it has
two environments, test
and online
. You can add more projects in the Projects
tab.
Here are the steps to add a new project:
Projects
tab to enter the projects page.+ Project
button in the top-right corner and open a new drawer page on the right to create a project.Create
button at the top of the drawer window. Now the project is created, and
it cannot be deleted.test
or online
) under a project to enter a
specific environment page and see the toggles.You can choose to edit a project by clicking the three-vertical-dot icon in the top-right corner of a project.
You can modify the selected project's name or/and description and save to make the changes into effective.
You can add new environments for your project and make the toggles accessible for different environment.
Here are the steps to add a new environment:
Add environment
menu item.Confirm
button to create the environment. It cannot be deleted once created.Note: A newly created environment shares the toggles of all the environments under the same project. But you need to set a toggle's configuration for a specific environment.
You can choose to edit an environment by clicking the three-vertical-dot icon in the top-right corner of an environment.
You can only change an environment's name at this time.
The FeatureProbe service provides powerful feature toggles management. You can manipulate the release of your business services or applications by changing the volume portion, controlling enabled features, and watching over the metrics with different toggles settings to ramp up new configurations until enabling it for everyone. The toggles setting works for different environment individually, and you can switch among different environments easily by using the drop-down menu in the upper-left corner inside a project page.
My First Project
online
environment.You can add new toggles for your project on the project page.
Here are the steps to add a new toggle:
true
and false
respectively. You cannot
change the variations number. You cannot change variations value (only "true" and "false" are allowed), and you can change
their name and description.Disabled return value
. It is the default value to be return when the toggle is disabled. By default, this
value will be set as variation1's disabled return value. You can change it.Create
button in the upper-right corner.Note: When a new toggle is created, the system will create a toggle template based on the new toggle automatically. And all environments under the same project share that template.
You can edit an existing toggle template. That operation will not change the existing toggle configuration and will be used for the new toggles that will be created in the future.
You can set up a toggle's configuration for a specific environment. A toggle must be configured for all environments individually, and the configuration doesn't shared among environments. You need to first select and enter a specific environment page and set up the toggle configuration afterward.
Here are the steps to configure a toggle:
Disabled return value
is effective,
otherwise, the Rules
and Default Rule
are effective.OR
operation.
An example: return special values for specific users.
Add rule
and fill in the rule name (you will see a placeholder reads "Rule 1" and please use your rule name to
replace it).Add Subject
, Select an operator
, and Enter some values
fields to set up a condition.publish
button and a diff of configurations will pop out.confirm
to make the configuration effective.The FeatureProbe provides a graphic report of toggles' accessing/usage information and the evaluation results. The report is environment specific.
Here are the key information of the reports:
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。