Skip to content

Latest commit

 

History

History
555 lines (426 loc) · 47.5 KB

CHANGELOG.md

File metadata and controls

555 lines (426 loc) · 47.5 KB

2022-01-25

What's new
Operation names can now be excluded from schema checks. Sometimes an operation ID is not enough to prevent failures while checking schemas, and to ignore expected failures on certain operations, we've introduced the ability to exclude operations by name from the Checks Config page. Excluded Operation Names

2022-01-11

What's new
We've updated the Graph Settings to be spread out across 5 tabs. We previously had just General and Access, and now we have General, Permissions, API Keys, Reporting, and Variants. image

2022-01-03 Happy new year! 🥳

What's new
Preflight scripts are now available in Explorer! Preflight scripts are really useful for managing authentication before operations are run. As graph producers, you can automate authentication against your graph endpoints to reduce friction for your graph consumers as much as possible, increasing graph usage and adoption. Simply click to add the code snippets and get started with your preflight scripts today! For details, see docs. image

2021-12-30

What's new
The Fields page can now display how many operations textually reference fields in addition to how many times the fields are executed. This can reveal connections hidden by field executions alone, and it enables you to use the page with federated graphs even if your subgraphs do not all support federated tracing. This new feature requires Apollo Server 3.6 or later. For details, see the Fields page docs. image

2021-12-16

What's new
You can now click the only link to quickly filter the clients to the only one you need. image

2021-12-15

What's new
Now you can publish your local schema to the Apollo registry directly from Sandbox! No need to go anywhere, just click Publish in Sandbox. image

2021-12-14

What's new
You can now opt in to using several different Datadog regions to forward metrics! image

2021-12-10

What's new
You can now sort fields in Explorer docs. Simply click on the arrow next to Fields. image

2021-12-02

What's new
Now you can diff your local schema against any registered schema in Apollo Studio, right from Sandbox and understand the changes made. image
You can also run operation checks right from Sandbox! While developing locally in Sandbox, make sure there are no breaking changes by running operation checks before pushing the updated schema to Studio. image

2021-11-01

What's new
We have upgraded the data visualization charts across Studio. This upgrade includes performance improvements, interaction upgrades, and numerous bug fixes. image

2021-10-29

🐛 Bug fix
We fixed a bug in Explorer where field latency approximation editor hints were displaying latencies 1000 times larger than the actual latency.

2021-10-26

What's new
We have made embedding Explorer MUCH easier! With our first release, you had to read and understand the full documentation and copy a volume of code in order to get started. But now you can just generate the code in a few clicks. Head over to Explorer for any public graph, and under Explorer Settings, find Embed Explorer. Toggle on/off options as you like, use the operation in your editor as the default and copy the code snippet to paste - that is it!! Embed Explorer to enable consumers to test out the graph from your own website, blog posts, documentation, etc. using the amazing Explorer experience. Read more here. image

2021-10-20

🐛 Bug fix
We fixed a bug in Schema Checks where excluding multiple client versions would cause the Schema Check to always fail.

2021-10-14

What's new
Graphs can now have avatar images, which you can set on your graph's settings page. image

2021-10-07

🐛 Bug fix
We fixed a bug on the Operations tab where changing the selected operation would also cause the client filter to lose its state.

2021-09-30

What's new
Admins can now share their graphs with users outside of their Studio organization. On the Graph Settings page, under the Access tab, toggle the switch for the specific graph variant you want to make public and share the public graph URL with consumers external to the Studio organization! Read more here. image
Given a public variant, graph producers can now embed Apollo Studio Explorer on any webpage to share that public variant with consumers! This will enable consumers to test out the graph from your own website, blog posts, documentation, etc. Read more here. image

2021-09-29 — ✨ The Champion Dashboard ✨

What's new
Org Admins now have access to a new page on their account, the Dashboard, which gives an overview of your Studio account's usage. The Dashboard Page shows your plan and its features, how many users you have and their roles, the support tickets submitted by members of your org, the request volumes sent by your graphs, the number of graphs and variants in your account, the schema publish volumes across your graphs, the number of checks being run by your graphs, and their success/failure rate. image

2021-09-23 — ✨ Tabs in Apollo Studio Explorer ✨

What's new
Test out multiple operations in different tabs when exploring your GraphQL API in Apollo Studio Explorer!! image

2021-09-20 — ✨ The README - A new graph landing page ✨

What's new
Graph maintainers can now provide information about the graph and how to get started with the graph natively in Apollo Studio with the new README page. The README appears as a new icon in the left nav in Apollo Studio and will now be the default page shown when navigating to any graph variant in Apollo Studio. README is not just another markdown, it also has one-click access to graph shortcodes - graph variables such as name, ref, SDL, endpoint, etc. that can be easily referred to in the README content. We have provided some default README content to get you started, so check it out today in Apollo Studio and get editing! image

2021-09-15 — ✨ Be offline and develop locally on Apollo Sandbox ✨

What's new
Offline support for local development with Apollo Sandbox is now available! 🎉 If you are developing locally using Sandbox, you can continue to work without any internet connection. In order to see this change, please reload at least one Sandbox tab while still connected to the internet one time (to update to the latest bundle) and after that continue to work without any internet connection.

2021-08-25

What's new
On the Launches page, you can now see which subgraphs changed as part of your launch, as well as whether they were modified, added, or removed! image

2021-08-19

What's new 🌔 🌕 🌚
We've updated Studio's top nav to be dark instead of light. We hope you enjoy this in particular when using the Explorer in dark mode :) image
We've updated Studio's new Launches feature to include a diff view of the supergraph schema! You can now see all schema-level changes in this view, and we'd love any feedback you have on how to enrich your experience further in the new Launches page. image

2021-08-18

🐛 Bug fix
We fixed a recently introduced Schema Checks bug where users were unable to mark changes as safe for "broken" operations.

2021-08-17 — ✨ New Feature: Launches ✨

What's new
For Studio Enterprise teams, there is a new tab within Studio that lets you observe the history and status of releases to your federated graph. Look for the rocket icon in your graph's home page to explore your federated launches in more detail! image

2021-08-05 — ✨ New Feature: Audit Logs ✨

What's new
For Studio Enterprise teams, it is now possible to export a data file with key actions taken within your organization. You can find the Audit Log interface under the "Audit" tab of your organization's home page. You can read more about the feature here. image

2021-08-04

What's new
It's now possible to delete variants that do not have active publishes or have invalid characters in their names image

2021-07-26

What's new
Default Headers are now generally available! In the Explorer Settings tab, Graph Administrators can specify headers that will be applied to every Explorer request executed by every user in your organization. image
You can now also provide sensitive tokens and information to header values in Explorer's Environment Variables tab. image

2021-07-20 — Organization Reorganization

What's new
It's now simpler than ever to navigate your organization (or multiple orgs) in Studio thanks to the new org picker. From the menu, you can switch organization context (if you are signed in to multiple orgs), create a new organization, or return to your organization index by selecting the organization item. image

2021-06-15 — ✨ New Page: Sandbox ✨

We have released Sandbox, making the Apollo Explorer openly available to any developer, with no login required.

Full details on the release in our announcement post: Apollo Sandbox: an open GraphQL IDE for local development .

image

2021-06-14

What's new
You can now cancel your Studio Team subscription, re-activate a canceled subscription, and switch between Monthly and Annual billing on your Organization's Settings page. No need to write into customer support for this anymore :) image (117)

2021-06-02

What's new
Headers in the Explorer can now be disabled so you can swap back and forth between them while you are testing without having to delete any. Additionally, any default headers added by your Graph Administrator will now show up as unmodifiable. image

2021-05-24

🐛 Bug fix
We had a bug where there were some circumstances where users couldn't rename their organizations. This is now fixed!

2021-05-20

What's new
The Checks page now includes a "status" filter to show only checks that match a specific status, making it easy to surface failed checks from your graph's check history. image

2021-05-07

What's new
The Schema > SDL page now features a type outline that you can use to quickly get to the type you are looking for without having to scroll through the entire SDL contents. image

2021-04-26

What's new
Role-specific invitation links are now available. You can create or manage invite links from you org's settings page. image

2021-04-20

What's new
Studio's onboarding has been significantly simplified. It now takes only one step to create an account and log in, as opposed to our previous multi-step onboarding wizard.

2021-04-19

What's new
The Checks page now includes schema composition details for federated graphs! Additionally, the Checks page now displays checks for all variants in the same area, and new filters allow you to find relevant checks by author, branch and subgraph. Read more in our announcement post.

2021-04-06

What's new
All plans on Apollo Studio now include unlimited read-only "Consumer" seats! You can now invite everyone in your organization to view your graphs in the registry, with access to Explorer, the schema reference, and the schema changelog. Read more in our announcement post. image

2021-04-01

What's new
Studio now includes several new features to improve the experience of working with Federated graphs. image
The Schema > Reference tab in Studio displays a table of your federated schema’s types and fields. This table now includes a Subgraph column image
Federated graphs will now also display their Subgraphs on the Schema > SDL tab (the older experience at the Services tab has moved here). This includes support for... image
...linking directly to types, fields, arguments and directives image
...filtering out comments & deprecated fields from view for a cleaner browsing experience image
...and using Studio search to jump directly to objects in your SDL image
Users with preview features enabled in personal settings will also be able to see the Supergraph SDL on the SDL page after your next schema push. image
You can now designate a contact person or team for each subgraph by using the @contact directive in your Subgraph SDL. image
...when you do, you'll see the Subgraph owner info displayed in the Subgraph SDL meta info on the Schema > SDL tab... image
...and when you hover over the Subgraph column for Schema objects in the Schema > Reference tab. image
If your graph has composition errors, the label on your Federated graph will display in an error state. image
Clicking the label will open the composition errors modal so you can see the errors from anywhere within Studio. image
The Schema > SDL page also displays a warning banner on the API schema and the Supergraph schema when composition has failed... image
...and error banners on the Subgraphs. image
Learn more about the new features for Federated graphs at the Federated Graphs in Studio Apollo Docs article.

2021-03-19

What's new
When creating a graph you can now see and change the id of your graph Screen Recording 2021-03-19 at 02 58 PM

2021-03-15

What's new
You can now see your Graph Reference on the Schema Reference page, which is useful when running commands with the Apollo CLI. Screen Shot 2021-03-15 at 1 14 21 PM
You can now see your Graph ID on your graph's settings page. Screen Shot 2021-03-15 at 1 15 05 PM

2021-03-09

What's new
⚡️ Significantly improved Schema Page's performance for very large schemas

2021-03-08

What's new
The creator and createdAt time for your Graph API keys are now visible in your Graph Settings. image
You can now write and save descriptions on your Graphs, which lets you differentiate them and describe them to your users more easily. image
You can now send headers along with your Introspection Queries when using Dev Graphs. image

2021-03-04

Security Upgrade
We have made a change to the way you use API keys with Studio: API keys are no longer be visible in plain text in your Graph and User Settings pages. You will only be able to see your API key secret in the moment that you first create it in Studio. This is security change we have made to reduce the probability of keys being accidentally leaked from our system. If you need to recover a token you have previously created, you can request help from us at support@apollographql.com. We recommend you just make a new token though. All existing keys will continue to work as-is, and no action is necessary as part of this change.

2021-02-26

What's new
Community and Team plans can now assign users the Billing Manager role, in addition to the default Org Admin role. You can change this on your organization's membership page.

2021-02-18

What's new
We added a feature to introduce Dev Graphs. If you have opened a Dev Graph recently you may see an informative popup! image

2021-02-17

What's new
We make a performance improvement to the Operations page; it should no longer slow down dramatically and/or become unresponsive when your graph has a very large number of clients.

2021-02-15

What's new
🚥 We shipped a small change to how Development Graphs poll their status so that they’re no longer polling for connectivity status on the Graph List page. When you're using a Dev Graph, you can also turn off its polling with the controls in the global nav.

2021-02-10

What's new
Defer loading of some data to making initial render of graph list faster Screen Recording 2021-02-15 at 06 55 15 PM

2021-02-08

Security Upgrade
We are upgrading our minimum TLS version to 1.2 for communications with our APIs. This is being done as 1.1 has largely been deprecated industry wide for some time now, and our client's security is a top concern for us. For more information, please see our StatusPage maintenance notice here
What's new
Protected variants and hidden graphs are now labeled as such in the Graph List page. image
You can now turn on a setting in the Explorer to inline the timings from your traces next to your operation's fields when you run your operation. Screen Shot 2021-01-28 at 6 34 12 PM

2021-02-03

What's new
We have moved all of our integrations configurations to the Graph Settings area. Please visit your graph's settings page if you are you looking to set up Slack notifications, Datadog forwarding, etc.

2021-02-01

What's new
We've added Schema Change Webhooks webhooks icon for our Enterprise customers! We also updated Studio to remove the Integrations section and integrate it into Settings.
  • You can now find Datadog settings under Settings > General.
  • Notification integrations including PagerDuty, Slack, and now Webhooks for Enterprise customers can be found under Settings > Notifications.
  • To setup a webhook for schema changes click Add Notification, select Schema Change, select the Variant you're interested in, Create new channel, Webhook.
  • Schema Change Webhooks will contain a string description of the schema change as well as a temporary URL which you can use to fetch the full updated schema. This link remains active for 24 hours.
  • See our updated documentation for more information, and let us know if you have any feedback - or interesting integrations - to share!

2021-01-29

What's new
The Recent Checks page has a new treatment of implementing services, along with clearer indications of the case when the "branch" or "author" is left un-set. Check it out! image

2021-01-28

🐛 Bug fix
We have fixed a (very) long-standing bug with our GitHub logins. Previously, if you changed your GitHub username and tried to log in to Studio again, you’d end up with a brand new unrelated account. (Also if your username was somebody else’s “old username” who had logged in to Studio from GH with that username, you were locked out of using Studio entirely.) We’ve fixed this: you can change your GitHub username as much as you want and you can still log in.

2021-01-27

What's new
The graph gelector dropdown in the top nav now extracts your favorites and current graph to the top of the options list. image

2021-01-26

What's new
In federated graphs, you can now see which subgraph(s) each field in your operations comes from in the Explorer. Screen Shot 2021-01-25 at 2 49 16 PM
Headers in the Explorer are now managed using input fields, instead of JSON :) Screen Shot 2021-01-25 at 6 13 11 PM

2021-01-19

What's new
We've enhanced the user roles system available to Enterprise customers!
  • Users can be granted a role on a specific graph with more permissions than their organization-level role.
  • A graph can be hidden from non-Organization Admin users that have not been explicitly granted a role on that graph.
  • Each graph API key now has a role (Graph Admin, Contributor, Observer, or Consumer) which limits their permissions. (Existing graph API keys retain their existing permissions.)
  • A new Graph Admin role has complete control over graphs (including managing graph-specific roles) but no organization-level administrative permissions. Existing Contributors have been changed to this role.
  • The Contributor role now is very similar to the Observer role, plus the ability to push new versions of the graph's schema. You can now mark individual variants as protected; you need to be a Graph Admin to push schemas to these variants.

2021-01-12

What's new
You can now hard delete organizations on your organization's Settings page. Previously, you needed to contact Apollo support to do this. When you hard delete an organization, the following things will happen:
  • If your organization is on a Team plan or Team trial, your subscription willl be immediately canceled. We can't issue refunds for this unfortunately.
  • All users memberships in your organization will be removed. Users of your organization will maintain their user accounts, but they will no longer be members of your org.
  • All graphs in your organization will be hard deleted. To keep your data secure, their graph IDs will be tombstoned and you will not be able to create new graphs with the same ID in the future.

2021-01-07

What's new
We have transitioned our underlying support system at Apollo from Intercom to Zendesk. If you need to get in touch with us, please file a ticket with our new Contact Support form (available in the top right corner of the Studio UI). Screen Shot 2021-01-07 at 10 01 45 AM

2021-01-05

What's new
We have updated the visual presentation of our Graphs list. Each graph is now represented as a card, we've added a settings link directly from the graph list, and we now represent links with blue to make them look more clickable. Screen Shot 2021-01-05 at 9 32 14 AM

2020-12-10

What's new
New layout for metrics filtering tools! Instead of an overlapping sidebar, we've embedded the controls for filtering by time range, clients, and operations directly into the page header. Now you can simply adjust the knobs without having to context-switch out of your current view. Updated Filter UX

2020-11-16

What's new in the Explorer
Don’t send unused variables over the wire Screen Recording 2020-11-16 at 04 00 42 PM
Visual Query Plans (rendered using mermaid) image
Table Mode column sorting Screen Recording 2020-11-16 at 06 03 23 PM
Download arrays from Table Mode to CSVs image
Choose the percentile (p50, p90, p99, etc) that you want your field latency hints displayed from image

2020-11-13

What's new
You can now inline and extract fragments from your operations in the Explorer by using the right-click context menu. Screen Recording 2020-11-11 at 02 49 40 PM

2020-11-06

What's new
You can now see and browse traces from your responses in the Explorer if you're using Apollo Server 2.18+ and add the ApolloServerPluginInlineTrace plugin Screen Recording 2020-11-06 at 02 43 57 PM
Better handle un-executable operation. Shows information tooltips and italicizes the constant identifiers for un-executable operations that we're added in Apollo Server 2.19.0 Screen Shot 2020-11-06 at 5 35 09 PM

2020-11-05

What's new
Small enhancement to Operations / Errors UX: links from errors to traces are now able to be opened in a new tab using CMD+click / CTRL+click. image

2020-10-31

What's new
Happy Halloween! Here's our present to you (no trick, just treat). In graphs using managed federation, you can now see query plans inlined next to your operations in the Explorer as you write them. The Explorer calculates query plans on the fly with your implementing services as input. Screen Recording 2020-10-30 at 04 43 32 PM

2020-10-30

What's new
You can now mock data from your operations in the Explorer with the "Mock responses" option in the Explorer's settings. This will return naively mocked data rather than sending requests to your endpoint. This is useful if you need to generate test data or if you want to try out queries without having and endpoint to send to. image

2020-10-29

What's new
You can now inline and extract variables from your operations in the Explorer by right-clicking in the Explorer's editor and selecting the "Inline" and "Extract" options from the context menu there. Screen Recording 2020-10-29 at 03 32 29 PM

2020-10-28

What's new
You can now display query response data in both JSON and in a table view using toggles at the top of the response pane in the Explorer. table-view-gif

2020-10-26

What's new
We've introduced a new experience in Studio that's optimized for bringing Studio's tools to you during local development. We have written some preview docs and the experience are accessible at studio.apollographql.com/dev. We willl be launching this experience more formally in November.

2020-10-23

What's new
Building off of recent updates to schema checks, you can now rerun checks from inside Studio. When you rerun a check, the latest check configuration is applied. The new check uses an updated time window for operations — in addition, any changes made to excluded / included clients, checked variants, and any operations already marked safe / ignored are incorporated when rerunning. If you are using the Github Action to trigger checks, a rerun of the check also updates the status of the check in Github. Rerun Checks Screenshot

2020-10-22

What's new
You can now see field latency performance stats inline in the Explorer as you write queries by turning this on in the Explorer's settings pane. ElTA31CUwAAvPuK

2020-10-19

What's new
Timestamps: additional timezone information is now included in many places where it was not before. In addition, hovering over a timestamp in the app will reveal both local time and UTC / ISO8601 time with "copy to clipboard" capability for sharing or syncing with other tools. Timestamps

2020-10-06

What's new
Schema Reference will now detect comments containing text matching the pattern of "TypeName.fieldName" and turn those into navigable links. Screen Recording 2020-10-06 at 09 56 11 PM

2020-10-02

What's new
The Datadog integration now sends metrics that start with apollo.operations instead of apollo.engine.operations and tags them with graph: rather than service:, to match our current naming scheme. This change affects newly configured Datadog integrations only. Graphs currently sending metrics to Datadog continue to use the old names; you can change to use the new names by clicking "Transition to modern mode" on your graph's Integrations page.

2020-09-24

What's new
Federation: you can now see composition errors on implementing services published to your variant. You can see these composition errors, if present, by clicking on the "services" tab of the variant in question.

2020-09-23

What's new
Creating new graphs with the Apollo Server integration is now simpler. Running your server with the APOLLO_KEY and
APOLLO_SCHEMA_REPORTING environment variables will now automatically report metrics and schema to Studio, with no configuration in ApolloServer itself necessary.

2020-09-16

  • Studio welcomes a new and improved check details page, featuring...
    • Request usage graphs of affected operations
    • Differentiation between operations that are broken vs. changing behavior
    • One-click views of operation bodies, change details, and check configuration
    • A brand new visual feel
    • ... and more! We hope you enjoy

2020-09-08

What's new
Explorer now supports subscriptions, you can set a separate subscription URL in the variant settings.

2020-09-01

What's new
When setting the endpoint url to be used in Explorer, you now have the option of configuring it to include cookies for all users.
The history and checks pages in Studio now link to the commit you were on when you ran service:push/service:check for GitHub and Bitbucket users.

2020-08-31

What's new
We'll make a best guess at reconstructing any unrecognized directives, so schemas that don't include definitions for directives should no longer crash the Schema or Explorer pages.
Improved experience for path selection in Explorer page's search
You can now favorite graph variants, which will pin the variant to the top of the graphs list page. Favorited variants are saved to your individual account, so you'll be able to see them when logging in on a new device. To favorite a graph, hover over your desired variant on the graph list page, and click the star icon on the left side. favorite-graphs

2020-08-28

What's new
You can now use graphql-lodash directives in studio to apply transformations to your results.
"Cancel" button now added to Upload Schema modal in Schema tab.

2020-08-26

What's new
User roles and permissions are now available in Studio by request –– email support@apollographql.com if you're interested. Take a look at our official documentation for the feature for a detailed breakdown on what permissions each role has.

2020-08-21

🐛 Bug fix
SSO users should see their name and avatar in Studio now (provided they've set up the attribute mapping via PingOne)

2020-08-20

🐛 Bug fix
Schema Checks no longer skip anonymous operations

2020-08-18

What's new
"Type Browser" has been renamed to "Reference"
Directives are now visible in "Reference" image
Types and Fields that appear in Changelog now link to their place in Reference
Reference is now searchable via ⌘ + K (Ctrl + K for PC) image

2020-08-05

New in general
You can now do a one-time schema upload to Studio by introspecting a URL or pasting a schema to get started much more quickly.
You can now do a one-time upload of your schema at any point by clicking the "Upload Schema" button on the Schema page. Screen Recording 2020-08-05 at 10 32 09 AM
New in the Explorer:
You can copy an operation to CURL from the Explorer's "meatball" context menu. Screen Recording 2020-08-03 at 12 22 39 PM

2020-07-29 –– ✨New Page: Schema ✨

We have released a new home page for your graph in Studio that contain's your graph's docs, changelog, and SDL.

New information about your schema:
Auto-generated documentation for type and field references. Changelog –– what changed and when. Full SDL.
Screenshot of Types page

2020-07-22 –– ✨New Page: Checks ✨

We have released the new Checks page for our schema checks feature. You can now see recent checks that have been run against and configure your check parameters from directly within the UI.

Screen Shot 2020-07-27 at 6 18 29 PM

2020-07-21

New in the Explorer:
You can now see inlined response hints in the Explorer. As you add fields to your query or change variables, the Explorer will make partial requests for new data. Screen Recording 2020-07-27 at 06 15 22 PM

2020-07-14

New in Integrations:
By popular request, you can now use the Datadog-forwarder with Datadog instances in the EU. Head to your graph's Integrations page to configure this 🌍 Screen Recording 2020-08-03 at 01 17 38 PM
New in the Explorer:
You can now configure requests to authenticate with your domain through cookies in the Explorer's settings tab 🍪 Screen Recording 2020-08-03 at 01 21 30 PM

2020-07-07

New in the Explorer:
You can now manage operations individually using a "meatball" context menu, even when other operations are invalid 🍝 Screen Recording 2020-08-03 at 01 23 27 PM
You can now generate variables for your query using autocomplete in the editor. Screen Recording 2020-08-03 at 01 24 22 PM

2020-06-30 –– ✨ New Page: Explorer ✨

We have released the Explorer, available as a top-level page for graphs. The Explorer is a full-featured query building IDE that connects to the registry and can be configured uniquely for each of your variants.

Full details on the release in our announcement post: Introducing the Apollo Explorer.

Building a query using the Explorer's query builder.

2020-06-29

We have formally renamed the product from Graph Manager to Studio, moved our URL from engine.apollographql.com to studio.apollographql.com, and have updated our website, docs, and in-product references to reflect the change.